Pengaturan Pengujian

Pengaturan

Pengujian dan integrasi dengan Pembayaran Berulang Xendit tidak memerlukan akun yang diaktifkan. Setelah Anda mendaftar akun Xendit gratis, Anda dapat segera memulai pengujian melalui API.

1. Untuk melakukan pengujian berulang dengan Xendit, terlebih dahulu buat kunci API rahasia dalam mode pengujian menggunakan dasbor Xendit. Pastikan untuk memberikan izin untuk Money-In sebagai WRITE
2. Siapkan URL callback pembayaran berulang Anda di bagian Callbacks pada tab Settings
3. Ikuti dan lihat Referensi API kami untuk mengetahui detail tentang persyaratan permintaan

Simulasi

Dalam mode uji coba, kami merekomendasikan pengujian pembuatan rencana pembayaran berulang menggunakan eWallet karena skenario uji coba mudah disiapkan. Alur hasil/simulasi yang sama harus berlaku untuk semua metode pembayaran lainnya. Dalam mode uji coba, Xendit menggunakan angka ajaib untuk membantu Anda menyelesaikan uji coba tanpa pengaturan yang rumit. Detail tentang metode pembayaran lainnya didokumentasikan setelah contoh.

Contoh Simulasi Sukses Pembuatan Rencana

1. Buat Rencana Pembayaran Berulang dengan amount = 13579

POST https://api.xendit.co/recurring/plans

{
  "reference_id": "test_reference_id",
  "customer_id": "cust-239c16f4-866d-43e8-9341-7badafbc019f",
  "recurring_action": "PAYMENT",
  "currency": "IDR",
  "amount": 13579,
  "schedule": {
    "reference_id": "test_reference_id",
    "interval": "MONTH",
    "interval_count": 1,
    "total_recurrence": 12,
    "anchor_date": "2022-02-15T16:23:52Z",
    "retry_interval": "DAY",
    "retry_interval_count": 3,
    "total_retry": 2,
    "failed_attempt_notifications": [2,4]
  },
  "immediate_action_type": "FULL_AMOUNT",
  "notification_config": {
    "recurring_created": ["WHATSAPP","EMAIL"],
    "recurring_succeeded": ["WHATSAPP","EMAIL"],
    "recurring_failed": ["WHATSAPP","EMAIL"],
    "locale": "en"},
  "failed_cycle_action": "STOP",
  "metadata": null,
  "description": "Video Game Subscription",
  "items": [
        {
            "type": "DIGITAL_PRODUCT",
            "name": "Cine Mraft",
            "net_unit_amount": 13579,
            "quantity": 1,
            "url": "https://www.xendit.co/",
            "category": "Gaming",
            "subcategory": "Open World"
        }
    ],
  "success_return_url": "https://www.xendit.co/successisthesumoffailures",
  "failure_return_url": "https://www.xendit.co/failureisthemotherofsuccess"
}

2. Lakukan penautan akun melalui eWallet di halaman penautan akun Xendit
3. Selesaikan alur hingga halaman sukses terlihat
4. Notifikasi webhook dan notifikasi pengguna akhir akan dikirimkan oleh Xendit

Contoh Simulasi Gagal Pembuatan Rencana

1. Buat Rencana Pembayaran Berulang dengan amount = 21110

POST https://api.xendit.co/recurring/plans

{
  "reference_id": "test_reference_id",
  "customer_id": "cust-239c16f4-866d-43e8-9341-7badafbc019f",
  "recurring_action": "PAYMENT",
  "currency": "IDR",
  "amount": 21110,
  "schedule": {
    "reference_id": "test_reference_id",
    "interval": "MONTH",
    "interval_count": 1,
    "total_recurrence": 12,
    "anchor_date": "2022-02-15T16:23:52Z",
    "retry_interval": "DAY",
    "retry_interval_count": 3,
    "total_retry": 2,
    "failed_attempt_notifications": [2,4]
  },
  "immediate_action_type": "FULL_AMOUNT",
  "notification_config": {
    "recurring_created": ["WHATSAPP","EMAIL"],
    "recurring_succeeded": ["WHATSAPP","EMAIL"],
    "recurring_failed": ["WHATSAPP","EMAIL"],
    "locale": "en"},
  "failed_cycle_action": "STOP",
  "metadata": null,
  "description": "Video Game Subscription",
  "items": [
        {
            "type": "DIGITAL_PRODUCT",
            "name": "Cine Mraft",
            "net_unit_amount": 21110,
            "quantity": 1,
            "url": "https://www.xendit.co/",
            "category": "Gaming",
            "subcategory": "Open World"
        }
    ],
  "success_return_url": "https://www.xendit.co/successisthesumoffailures",
  "failure_return_url": "https://www.xendit.co/failureisthemotherofsuccess"
}

2. Lakukan penautan akun melalui eWallet di halaman penautan akun Xendit
3. Selesaikan alur hingga halaman yang gagal terlihat
4. Notifikasi webhook dan notifikasi pengguna akhir akan dikirimkan oleh Xendit

Contoh Simulasi Siklus Sukses

1. Simulasi Siklus Pembayaran Berulang dengan amount = 13579

POST https://api.xendit.co/recurring/plans/:plan_id/cycles/:id/simulate

{
  "amount": 13579
}

2. Notifikasi webhook dan notifikasi pengguna akhir akan dikirimkan oleh Xendit

Contoh Simulasi Siklus Gagal

1. Simulasi Siklus Pembayaran Berulang dengan amount = 21110

POST https://api.xendit.co/recurring/plans/:plan_id/cycles/:id/simulate

{
  "amount": 21110
}

2. Notifikasi webhook dan notifikasi pengguna akhir akan dikirimkan oleh Xendit

Daftar angka simulasi

eWallets

Skenario	Jumlah Simulasi	Hasil Akhir
Akun pelanggan diblokir provider	Amount = 21103	ACCOUNT_ACCESS_BLOCKED kode kegagalan melalui callback
Akun pelanggan tidak valid	Amount = 21106	INVALID_ACCOUNT_DETAILS kode kegagalan melalui callback
Akun pelanggan telah mencapai batas maksimum transaksi	Amount = 20107	MAXIMUM_LIMIT_REACHED kode kegagalan melalui callback
Saldo pelanggan tidak cukup	Amount = 21110	INSUFFICIENT_BALANCE kode kegagalan melalui callback

Kartu kredit - lihat (cards testing)[https://docs.xendit.co/credit-cards/integrations/test-scenarios] untuk nomor kartu yang berfungsi dalam mode uji. Tanggal kedaluwarsa dan CVV dapat diinput secara bebas.

Skenario	Jumlah Simulasi	Hasil Akhir
Kartu yang Anda gunakan telah kedaluwarsa	Jumlah = 10051	EXPIRED_CARD kode kegagalan melalui callback
Kartu yang Anda gunakan ditolak oleh bank penerbit	Jumlah = 10052	CARD_DECLINED kode kegagalan melalui callback
Kartu yang Anda gunakan tidak memiliki saldo cukup untuk transaksi ini	Jumlah = 10054	INSUFFICIENT_BALANCE kode kegagalan melalui callback
Kartu yang Anda gunakan ditandai sebagai curian	Jumlah = 10055	STOLEN_CARD kode kegagalan melalui callback
Kartu yang Anda gunakan tidak aktif	Jumlah = 10056	INACTIVE_CARD kode kegagalan melalui callback
Kartu yang Anda gunakan ditolak karena CVN tidak sesuai	Jumlah = 10059	INVALID_CVN kode kegagalan melalui callback

Direct debit - lihat (direct debit testing)[https://docs.xendit.co/direct-debit/integration-guide/account-linking] untuk detail penautan akun dalam mode uji coba.

Skenario	Jumlah Simulasi	Hasil Akhir
Transaksi melebihi batas harian yang diizinkan bank	Jumlah = 11001	MAX_AMOUNT_LIMIT_ERROR kode kegagalan melalui callback
Saldo pelanngan tidak cukup untuk transaksi ini	Jumlah = 11002	INSUFFICIENT_BALANCE kode kegagalan melalui callback
Bank telah memblokir akses ke akun	Jumlah = 11004	ACCOUNT_ACCESS_BLOCKED kode kegagalan melalui callback