Testing Process

Uji integrasi Anda dengan kartu pengujian, ID UPI, data BNPL, dan dompet digital. Simulasikan pembayaran, pengembalian dana, dan kegagalan tanpa tagihan nyata.

Gunakan kredensial pengujian di halaman ini untuk mensimulasikan pembayaran yang berhasil, ditolak, dan gagal dalam mode pengujian. Tidak ada uang yang berpindah dan tidak ada akun nyata yang dikenai biaya. Untuk melihat pembayaran pengujian lengkap, tonton video ini.

Full API Access

Setiap API endpoint tersedia dalam mode pengujian.

Webhook Testing

Webhook dipicu untuk transaksi pengujian dengan cara yang sama seperti di production.

Kredensial pengujian hanya berfungsi dalam mode pengujian. Dalam mode live, pembayaran yang dibuat dengan kredensial pengujian akan gagal.

​

Kartu Pengujian

Gunakan nomor kartu ini untuk mensimulasikan pembayaran yang berhasil dan ditolak di berbagai wilayah.

Successful Payments

Wilayah	Merek	Nomor Kartu	Kedaluwarsa	CVV
US	Visa	4242424242424242	06/32	123
US	Mastercard	5555555555554444	06/32	123
India	Visa	4576238912771450	06/32	123
India	Mastercard	5409162669381034	06/32	123

Declined Payments

Wilayah	Merek	Nomor Kartu	Skenario	Kode Error
US	Visa	4000000000000002	Penolakan umum	GENERIC_DECLINE
US	Visa	4000000000009995	Dana tidak mencukupi	INSUFFICIENT_FUNDS
India	Visa	4706131211212123	Penolakan umum	GENERIC_DECLINE
India	Mastercard	5105105105105100	Penolakan umum	GENERIC_DECLINE

Saat kartu pengujian ditolak, error_code dan error_message pembayaran mencerminkan skenario di atas. Cari arti dan tindakan yang disarankan untuk setiap kode di referensi Transaction Failures. Lihat Handle Payment Failures untuk menangani penolakan dalam integrasi Anda.

Subscription Renewal Failures

Nomor Kartu	Kedaluwarsa	CVV
4000000000000341	12/34	123

Gunakan kartu ini untuk menguji kegagalan perpanjangan, peningkatan, dan penurunan subscription. Subscription yang menggunakan kartu ini akan ditolak pada tagihan berikutnya, sehingga Anda dapat menguji percobaan ulang, notifikasi pelanggan, dan penanganan kegagalan Anda.

Untuk semua kartu pengujian, gunakan tanggal kedaluwarsa 06/32 (atau 12/34) dan CVV 123.

​

Menguji Kegagalan Perpanjangan

1. Create a test subscription

   Buat subscription dengan API key pengujian menggunakan kartu pengujian yang berhasil (misalnya, 4242424242424242). Tagihan awal harus berhasil dan subscription harus menjadi aktif.

2. Update the payment method

   Buka Customer Portal, cari subscription, lalu klik Update Payment Method. Masukkan kartu pengujian kegagalan 4000000000000341 (Kedaluwarsa: 12/34, CVV: 123), lalu simpan.

3. Advance the next billing date (optional)

   Untuk memicu perpanjangan segera, bukan menunggu siklus penagihan alami, gunakan API Update Subscription untuk menetapkan next_billing_date ke waktu UTC saat ini, dengan mengganti nilai contoh di bawah. Nilai tersebut harus berupa timestamp UTC ISO 8601 / RFC 3339 (akhiran Z wajib disertakan).

   PATCH /subscriptions/{subscription_id}
   {
     "next_billing_date": "2026-05-03T00:00:00Z"
   }
   

   Lihat referensi API Update Subscription untuk detailnya.

4. Verify the failure

   Pada percobaan penagihan berikutnya:

   • Tagihan perpanjangan ditolak pada kartu kegagalan
   • Subscription berpindah ke Past Due terlebih dahulu (masa tenggang; webhook subscription.past_due membawa past_due_ends_at), lalu ke On-Hold saat masa tenggang berakhir
   • Event webhook payment.failed dikirimkan
   • Pelanggan dapat kembali ke Customer Portal untuk memperbarui metode pembayaran dan mencoba lagi

​

UPI Pengujian

Pengujian UPI menggunakan identifier VPA (Virtual Payment Address) khusus yang menyimulasikan berbagai hasil pembayaran.

Status	ID UPI
Berhasil	success@upi
Gagal	failure@upi

​

Persyaratan Pengujian UPI

• Negara penagihan harus ditetapkan ke IN
• Mata uang harus berupa INR
• Untuk merchant non-India: Adaptive Currency harus diaktifkan

Untuk dokumentasi UPI lengkap, termasuk pengujian mandat RBI untuk subscription, lihat halaman Metode Pembayaran India.

​

Pix Pengujian

Pengujian Pix menggunakan CPF pengujian (ID pajak Brasil) untuk menyimulasikan alur kode QR.

Kolom	Nilai Pengujian
CPF	00000000000 (11 angka nol)

​

Persyaratan Pengujian Pix

• Negara penagihan harus ditetapkan ke BR
• Mata uang harus berupa BRL

Masukkan CPF pengujian saat diminta di checkout. Kode QR pengujian akan dibuat — pindai dengan kamera ponsel biasa Anda (tidak memerlukan aplikasi Pix), lalu Anda akan dialihkan ke halaman pengujian tempat Anda dapat menyimulasikan transaksi sebagai berhasil atau gagal.

Untuk dokumentasi Pix lengkap, lihat halaman Pix.

​

BNPL Pengujian

Penyedia Buy Now Pay Later memiliki persyaratan data pengujian tertentu.

​

Data Pengujian Klarna

Gunakan detail ini untuk menyimulasikan pembayaran Klarna dalam mode pengujian:

Kolom	Disetujui	Ditolak
Tanggal Lahir	07-10-1970	07-10-1970
Nama Depan	Test	Test
Nama Belakang	Person-us	Person-us
Email	[e-mail]	[e-mail]
Jalan	Amsterdam Ave	Amsterdam Ave
Nomor Rumah	509	509
Kota	New York	New York
Negara Bagian	New York	New York
Kode Pos	10024-3941	10024-3941
Telepon	[phone]	[phone]

Pada checkout USD, Klarna memerlukan jumlah transaksi minimum sebesar $50.01 agar muncul sebagai opsi pembayaran.

​

Pengujian Afterpay

1. Select Afterpay

   Pilih Afterpay sebagai metode pembayaran saat checkout, lalu klik Pay.

2. Test successful payment

   Gunakan alamat email dan alamat pengiriman valid apa pun untuk pembayaran yang berhasil.

3. Test failed authentication

   Untuk menyimulasikan kegagalan, tutup jendela modal Afterpay di halaman pengalihan. Pembayaran berpindah dari requires_customer_action ke requires_payment_method.

Pada checkout USD, Afterpay memerlukan jumlah transaksi minimum sebesar $50.01 agar muncul sebagai opsi pembayaran.

Untuk dokumentasi BNPL lengkap, termasuk pengujian Billie B2B, lihat halaman Buy Now Pay Later.

​

Dompet Digital Pengujian

​

Apple Pay

1. Enable test mode

   Nonaktifkan sakelar Live Mode di sidebar dashboard dan gunakan API key yang dibuat dalam mode pengujian. Lihat Test Mode vs Live Mode.

2. Add a card to Apple Wallet

   Tambahkan kartu nyata ke Apple Wallet Anda. Dalam mode pengujian, kartu tidak akan dikenai biaya.

3. Complete test purchase

   Buka checkout di perangkat Apple dan selesaikan alur Apple Pay.

Apple Pay memerlukan HTTPS. Apple Pay tidak akan muncul di localhost tanpa konfigurasi SSL yang benar. Verifikasi domain juga harus selesai.

​

Google Pay

1. Join the test card group

   Bergabunglah dengan grup kartu pengujian Google Pay untuk mendapatkan kartu pengujian yang otomatis ditambahkan ke wallet Anda.

2. Enable test mode

   Nonaktifkan sakelar Live Mode di sidebar dashboard dan gunakan API key yang dibuat dalam mode pengujian. Lihat Test Mode vs Live Mode.

3. Complete test purchase

   Pilih salah satu kartu pengujian di Google Pay untuk menyelesaikan transaksi.

​

Amazon Pay, Cash App Pay, dan RevolutPay

Gunakan API key pengujian Anda dan ikuti alur checkout standar. Transaksi pengujian disimulasikan tanpa tagihan nyata.

Untuk dokumentasi dompet digital lengkap, termasuk verifikasi domain untuk Apple Pay, lihat halaman Dompet Digital.

​

ACH Direct Debit Pengujian

ACH Direct Debit dapat diuji dalam mode pengujian dengan memasukkan detail bank pengujian saat checkout.

1. Enable test mode

   Nonaktifkan sakelar Live Mode di sidebar dashboard dan gunakan API key yang dibuat dalam mode pengujian. Lihat Test Mode vs Live Mode.

2. Set currency and billing address

   Tetapkan mata uang penagihan ke USD dan negara alamat penagihan ke US. ACH tidak ditawarkan di luar kombinasi ini.

3. Use a one-time payment

   ACH tidak tersedia pada checkout subscription, jadi uji dengan pembayaran satu kali.

4. Enter the test bank details

   Masukkan salah satu pasangan routing number dan account number pengujian di bawah, lalu pastikan handler webhook Anda menerima status pembayaran final — pembayaran ACH dikonfirmasi secara asynchronous, bukan saat checkout.

​

Rekening Bank Pengujian

Gunakan routing number 110000000 dengan salah satu account number berikut:

Account Number	Perilaku
000123456789	Pembayaran berhasil.
000222222227	Pembayaran gagal karena dana tidak mencukupi.
000111111113	Pembayaran gagal karena rekening ditutup.
000555555559	Pembayaran berhasil, lalu memicu dispute.
000000000009	Pembayaran terus diproses tanpa batas waktu.

Untuk daftar lengkap rekening pengujian, lihat halaman ACH Direct Debit.

​

Metode Eropa Pengujian

Metode pembayaran Eropa (iDEAL, Bancontact, EPS, Multibanco) dapat diuji dalam mode pengujian.

Multibanco menampilkan voucher, bukan alur bank. Lihat Test Multibanco.

1. Enable test mode

   Nonaktifkan tombol Live Mode di sidebar dashboard, lalu gunakan API keys yang dibuat dalam test mode. Lihat Test Mode vs Live Mode.

2. Set billing address

   Atur negara alamat penagihan agar sesuai dengan payment method:

   • NL untuk iDEAL
   • BE untuk Bancontact
   • AT untuk EPS
   • PT untuk Multibanco
3. Set currency

   Payment methods Eropa memerlukan mata uang EUR.

4. Complete test flow

   Ikuti alur autentikasi bank yang disimulasikan di test environment.

​

Test Multibanco

Gunakan EUR dan alamat penagihan PT. Setelah mengeklik Pay, checkout menampilkan voucher Multibanco. Dalam test mode, email yang Anda masukkan menentukan hasilnya:

Email	Hasil
[e-mail]	Pembayaran berhasil dalam beberapa detik.
[e-mail]	Pembayaran gagal dalam beberapa detik.

Untuk melihat halaman keberhasilan, gunakan [e-mail], tunggu beberapa detik, lalu ketuk Done.

Untuk daftar lengkap email pengujian, lihat halaman Europe.

​

Test SEPA Direct Debit IBANs

SEPA Direct Debit memerlukan EUR dan alamat penagihan di Eurozone. Gunakan IBAN pengujian berikut untuk memaksa hasil tertentu:

Test IBAN	Perilaku
DE89370400440532013000	Pembayaran berhasil.
DE62370400440532013001	Pembayaran gagal.
DE35370400440532013002	Pembayaran berhasil, lalu langsung disengketakan.
DE65370400440002222227	Pembayaran gagal karena dana tidak mencukupi.

Untuk daftar lengkap test IBANs, termasuk nilai per negara, lihat halaman Europe.

Untuk dokumentasi lengkap payment methods Eropa, lihat halaman Europe.

​

Test Asia-Pacific Wallets

GCash, Alipay HK, FPS, dan Touch ‘n Go adalah pembayaran kode QR yang hanya muncul jika negara dan mata uang penagihan sesuai.

1. Enable test mode

   Nonaktifkan tombol Live Mode di sidebar dashboard, lalu gunakan API keys yang dibuat dalam test mode. Lihat Test Mode vs Live Mode.

2. Set billing country and currency

   Buat checkout satu kali dengan pasangan yang sesuai:

   Method	Billing Country	Billing Currency	Method Type
   GCash	PH	PHP	gcash
   Alipay HK	HK	HKD	ali_pay_hk
   FPS	HK	HKD atau CNY	fps
   Touch ‘n Go	MY	MYR	touch_n_go

3. Select the method and confirm

   Pilih method tersebut dan klik Pay. Kode QR terbuka dalam overlay layar penuh dan checkout menunggu pembayaran.

4. Verify the checkout behavior

   Pastikan method tersebut hanya muncul untuk negara dan mata uang yang sesuai, serta kode QR ditampilkan.

Kode QR dalam test mode diterbitkan oleh test environment penyedia wallet dan mungkin berperilaku berbeda dari pembayaran live.

Untuk dokumentasi lengkap, lihat halaman Asia-Pacific.

​

Praktik Terbaik Pengujian

Test all payment scenarios

Jangan hanya menguji pembayaran yang berhasil. Uji penolakan, pembatalan, dan kasus khusus seperti dana tidak mencukupi.

Verify webhook handling

Pastikan endpoint webhook Anda memproses semua jenis event dengan benar, terutama payment.succeeded, payment.failed, dan event subscription.

Gunakan Dodo Payments CLI untuk menguji webhook secara lokal:

• dodo wh listen meneruskan webhook pengujian live ke server lokal Anda
• dodo wh trigger mengirim payload tiruan untuk semua jenis event webhook yang didukung

Test on real devices

Untuk Apple Pay dan Google Pay, lakukan pengujian di perangkat iOS dan Android yang sebenarnya. Simulator tidak sepenuhnya mereplikasi perilaku wallet.

Test regional methods with correct addresses

Payment methods regional (UPI, iDEAL, dan lainnya) memerlukan alamat penagihan yang sesuai. Alamat penagihan AS tidak akan menampilkan iDEAL.

Verify minimum amounts

Klarna dan Afterpay memerlukan minimum $50.01 pada checkout USD. Uji apakah keduanya muncul atau tersembunyi dengan benar berdasarkan total keranjang.

​

Halaman Terkait

Cards

Pengujian kartu, 3D Secure, dan payment methods tersimpan.

Digital Wallets

Pengujian Apple Pay, Google Pay, dan Amazon Pay.

BNPL

Pengujian Klarna, Afterpay, dan Billie.

India

Pengujian mandat UPI dan RBI.

Pix

Pengujian Pix dengan test CPF.

Europe

Pengujian iDEAL, Bancontact, EPS, dan Multibanco.

Asia-Pacific

Pengujian GCash, Alipay HK, FPS, dan Touch ‘n Go.

Webhooks

Siapkan webhook untuk event pengujian.

CLI Webhook Testing

Uji webhook secara lokal dengan Dodo Payments CLI.