Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Ikhtisar

Mode uji memungkinkan Anda mensimulasikan pembayaran tanpa memproses transaksi nyata. Semua kredensial uji hanya berfungsi dalam mode uji — jangan pernah menggunakannya dalam produksi.

No Real Charges

Transaksi uji tidak memproses pembayaran aktual atau memengaruhi akun nyata.

Full API Access

Semua endpoint API bekerja sama dalam mode uji dan langsung.

Webhook Testing

Webhook dipicu untuk transaksi uji sama seperti produksi.
Kredensial uji hanya berfungsi dalam mode uji. Mencoba menggunakannya dalam mode langsung akan menyebabkan kegagalan pembayaran.

​
Kartu Uji

Gunakan nomor kartu ini untuk mensimulasikan pembayaran yang berhasil dan ditolak di berbagai wilayah.
WilayahMerekNomor KartuKadaluarsaCVV
USVisa424242424242424206/32123
USMastercard555555555555444406/32123
IndiaVisa457623891277145006/32123
IndiaMastercard540916266938103406/32123
Untuk semua kartu uji, gunakan tanggal kadaluarsa 06/32 (atau 12/34) dan CVV 123.

​
Cara Menguji Kegagalan Pembaruan

1

Create a test subscription

Buat langganan dengan kunci API uji Anda menggunakan kartu uji sukses (misalnya, 4242 4242 4242 4242). Pembayaran awal seharusnya berhasil dan langganan akan menjadi aktif.
2

Swap in the failure card via Customer Portal

Buka Portal Pelanggan, temukan langganan yang baru Anda buat, dan klik Perbarui Metode Pembayaran. Masukkan kartu uji kegagalan 4000 0000 0000 0341 (Kadaluarsa: 12/34, CVC: 123) dan simpan sebagai metode pembayaran langganan.
3

Advance the next billing date (optional)

Untuk memicu pembaruan segera daripada menunggu siklus penagihan alami, gunakan Update Subscription API untuk mengatur next_billing_date ke waktu UTC saat ini. Nilainya harus berupa stempel waktu UTC ISO 8601 / RFC 3339 (diperlukan akhiran Z).
PATCH /subscriptions/{subscription_id}
{
  "next_billing_date": "2026-05-03T00:00:00Z"
}
Lihat Referensi API Pembaruan Langganan untuk detailnya.
4

Verify the failure

Pada percobaan penagihan berikutnya:
  • Pembaruan penagihan ditolak pada kartu kegagalan
  • Langganan bergerak ke status Ditangguhkan
  • Acara webhook payment.failed dikirim
  • Pelanggan dapat kembali ke Portal Pelanggan untuk memperbarui metode pembayaran dan mencoba lagi
Kartu ini secara khusus untuk menguji kegagalan pembaruan. Tagihan akan ditolak pada tanggal penagihan berikutnya, memungkinkan Anda menguji logika coba ulang pembayaran, pemberitahuan pelanggan, dan penanganan kegagalan.

​
Uji UPI

Pengujian UPI menggunakan pengidentifikasi khusus VPA (Virtual Payment Address) yang mensimulasikan hasil pembayaran berbeda.
StatusUPI ID
Suksessuccess@upi
Kegagalanfailure@upi

​
Persyaratan untuk Uji UPI

  • Negara penagihan harus diatur ke IN
  • Mata uang harus INR
  • Untuk pedagang non-India: Mata uang adaptif harus diaktifkan
Untuk dokumentasi UPI lengkap termasuk pengujian mandat RBI untuk langganan, lihat halaman Metode Pembayaran India.

​
Uji BNPL

Penyedia Buy Now Pay Later memiliki persyaratan data uji khusus.

​
Data Uji Klarna

Gunakan detail berikut untuk mensimulasikan pembayaran Klarna dalam mode uji:
BidangDisetujuiDitolak
Tanggal Lahir07-10-197007-10-1970
Nama DepanTestTest
Nama BelakangPerson-usPerson-us
Emailcustomer@email.uscustomer+denied@email.us
JalanAmsterdam AveAmsterdam Ave
Nomor Rumah509509
KotaNew YorkNew York
Negara BagianNew YorkNew York
Kode Pos10024-394110024-3941
Telepon+13106683312+13106354386
Klarna mensyaratkan jumlah transaksi minimum sebesar $50.01 agar muncul sebagai opsi pembayaran.

​
Pengujian Afterpay

1

Select Afterpay

Pilih Afterpay sebagai metode pembayaran di checkout dan klik Bayar.
2

Test successful payment

Gunakan alamat email yang valid dan alamat pengiriman untuk pembayaran berhasil.
3

Test failed authentication

Untuk mensimulasikan kegagalan, tutup jendela modal Afterpay pada halaman pengalihan. Pembayaran beralih dari requires_action ke requires_payment_method.
Afterpay mensyaratkan 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.

​
Uji Dompet Digital

​
Apple Pay

1

Enable test mode

Gunakan kunci API uji Dodo Payments Anda.
2

Add a card to Apple Wallet

Tambahkan kartu sebenarnya ke Apple Wallet Anda. Dalam mode uji, kartu tidak akan dikenakan biaya.
3

Complete test purchase

Buka checkout pada perangkat Apple dan selesaikan alur Apple Pay.
Apple Pay memerlukan HTTPS. Itu tidak akan muncul di localhost tanpa pengaturan SSL yang tepat. Verifikasi domain juga harus lengkap.

​
Google Pay

1

Join the test card group

Bergabunglah dengan grup kartu uji Google Pay untuk mendapatkan kartu uji yang otomatis ditambahkan ke dompet Anda.
2

Enable test mode

Gunakan kunci API uji Dodo Payments Anda.
3

Complete test purchase

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

​
Amazon Pay, Cash App Pay & RevolutPay

Gunakan kunci API uji Anda dan ikuti alur checkout standar. Transaksi uji disimulasikan tanpa biaya nyata. Untuk dokumentasi dompet digital lengkap termasuk verifikasi domain untuk Apple Pay, lihat halaman Dompet Digital.

​
Uji Metode Eropa

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

Enable test mode

Gunakan kunci API uji Dodo Payments Anda.
2

Set billing address

Setel negara alamat penagihan untuk mencocokkan metode pembayaran:
  • NL untuk iDEAL
  • BE untuk Bancontact
  • AT untuk EPS
  • PT untuk Multibanco
3

Set currency

Metode Eropa memerlukan mata uang EUR.
4

Complete test flow

Ikuti alur autentikasi bank yang disimulasikan dalam lingkungan pengujian.
Untuk dokumentasi metode pembayaran Eropa lengkap, lihat halaman Eropa.

​
Praktik Pengujian Terbaik

Jangan hanya menguji pembayaran yang berhasil. Uji penolakan, pembatalan, dan kasus tepi seperti dana yang tidak mencukupi.
Pastikan endpoint webhook Anda memproses semua jenis acara dengan benar, terutama payment.succeeded, payment.failed, dan acara langganan.Gunakan Dodo Payments CLI untuk menguji webhooks secara lokal:
  • dodo wh listen meneruskan webhook uji langsung ke server lokal Anda
  • dodo wh trigger mengirim payload tiruan untuk semua 22 jenis acara
Untuk Apple Pay dan Google Pay, uji pada perangkat iOS dan Android yang sebenarnya. Simulator tidak sepenuhnya mereplikasi perilaku dompet.
Metode pembayaran regional (UPI, iDEAL, dll.) memerlukan alamat penagihan yang cocok. Alamat penagihan AS tidak akan menampilkan iDEAL.
Metode BNPL memerlukan minimum $50.01. Uji bahwa metode tersebut muncul/tersembunyi dengan benar berdasarkan total keranjang.

​
Halaman Terkait

Cards

Pengujian kartu, 3D Secure, dan metode pembayaran yang disimpan.

Digital Wallets

Pengujian Apple Pay, Google Pay, Amazon Pay.

BNPL

Pengujian Klarna, Afterpay, dan Billie.

India

Pengujian UPI dan mandat RBI.

Europe

Pengujian iDEAL, Bancontact, EPS, Multibanco.

Webhooks

Siapkan webhooks untuk acara uji.

CLI Webhook Testing

Uji webhooks secara lokal dengan Dodo Payments CLI.
Last modified on May 4, 2026