Percobaan

Untuk mencoba integrasi Anda, simulasikan transaksi tanpa memindahkan uang dengan menggunakan nilai percobaan khusus di sandbox. Anda dapat mengakses sandbox menggunakan pemilih akun di kanan atas halaman atau di Dashboard.

Kartu percobaan berfungsi sebagai kartu kredit palsu, dan memungkinkan Anda menyimulasikan skenario berikut:

• Pembayaran berhasil berdasarkan brand kartu atau negara
• Card errors due to declines, fraud, or invalid data
• Sengketa dan pengembalian dana
• Autentikasi dengan 3D Secure dan PIN

Percobaan pembayaran nonkartu juga sama cara kerjanya. Pembayaran nonkartu adalah metode pembayaran yang bukan kartu kredit atau debit. Stripe mendukung berbagai opsi pembayaran nonkartu, seperti dompet digital dan transfer bank. Setiap metode pembayaran memiliki nilai khusus tersendiri.

Jangan gunakan lingkungan percobaan untuk melakukan percobaan beban integrasi karena Anda mungkin mencapai batas rasio. Untuk melakukan percobaan beban integrasi Anda, lihat percobaan beban.

Cara menggunakan kartu percobaan

Kapan saja Anda menggunakan kartu percobaan, gunakan kunci API percobaan di semua panggilan API. Hal ini berlaku saat Anda menyajikan formulir pembayaran untuk mencobanya secara interaktif, atau menulis kode percobaan.

Mencoba secara interaktif

Ketika mencoba secara interaktif, gunakan nomor kartu, seperti 4242 4242 4242 4422. Masukkan nomor kartu di Dashboad atau di segala formulir pembayaran.

• Gunakan tanggal mendatang yang valid, seperti 12/34.
• Gunakan tiga angka CVC (empat angka untuk kartu American Express).
• Gunakan nilai yang Anda sukai untuk bidang formulir lainnya.

Mencoba formulir secara interaktif dengan nomor kartu percobaan 4242 4242 4242 4242

Kode percobaan

Ketika menulis kode percobaan, gunakan PaymentMethod seperti pm_card_visa, bukan nomor kartu. Kami tidak merekomendasikan penggunaan nomor kartu secara langsung di panggilan API atau kode sisi server, bahkan di lingkungan percobaan. Jika menggunakannya, kode Anda mungkin tidak kompatibel dengan PCI saat live. Secara default, PaymentMethod tidak dilampirkan pada Pelanggan.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=500 \
  -d currency=gbp \
  -d payment_method=pm_card_visa \
  -d "payment_method_types[]"=card

Sebagian besar integrasi tidak menggunakan Token lagi, tetapi kami menyediakan Token percobaan seperti tok_visa jika Anda membutuhkannya.

Bila Anda sudah siap menjadikan integrasi live, ganti kunci API percobaan yang dapat dipublikasikan dan rahasia dengan kunci live. Anda tidak dapat memproses pembayaran live jika integrasi masih menggunakan kunci API percobaan.

Kartu berdasarkan brand

Untuk menyimulasikan pembayaran yang berhasil untuk brand kartu tertentu, gunakan kartu percobaan dari daftar berikut.

Sebagian besar kartu Cartes Bancaires dan eftpos memiliki merek bersama dengan Visa atau Mastercard. Kartu uji dalam tabel berikut mensimulasikan pembayaran yang berhasil dengan kartu merek bersama.

Kartu berdasarkan negara

Untuk menyimulasikan keberhasilan pembayaran dari negara tertentu, gunakan kartu percobaan dari bagian berikut.

Kartu percobaan HSA dan FSA

Di bawah ini adalah nomor kartu percobaan untuk menyimulasikan transaksi menggunakan Health Savings Accounts (HSA) dan Flexible Spending Accounts (FSA). Rekening-rekening ini biasanya digunakan untuk pengeluaran medis, dan percobaan dengan rekening-rekening tersebut memastikan penanganan yang tepat atas transaksi terkait perawatan kesehatan dalam aplikasi Anda.

Pembayaran yang ditolak

Untuk mencoba logika penanganan kesalahan integrasi Anda dengan menyimulasikan pembayaran yang ditolak oleh penerbit karena berbagai alasan, gunakan kartu percobaan dari bagian ini. Penggunaan salah satu kartu ini menghasilkan kesalahan kartu dengan kode kesalahan dan kode penolakan tertentu.

Pencegahan penipuan

Sistem pencegahan penipuan Stripe, Radar, dapat memblokir pembayaran ketika mereka memiliki tingkat risiko tinggi atau pemeriksaan verifikasi gagal. Anda bisa menggunakan kartu-kartu di bagian ini untuk mencoba pengaturan Radar. Anda juga dapat menggunakannya untuk mencoba tanggapan integrasi terhadap pembayaran yang diblokir.

Setiap kartu menyimulasikan faktor-faktor risiko tertentu. Pengaturan Radar Anda menentukan faktor risiko yang menyebabkan pemblokiran pembayaran. Pembayaran yang diblokir menghasilkan kesalahan kartu dengan kode kesalahan penipuan.

Data tidak valid

Untuk mencoba kesalahan akibat data yang tidak valid, berikan detail yang tidak valid. Anda tidak perlu kartu percobaan khusus untuk ini. Nilai tidak valid apa pun bisa digunakan. Sebagai contoh:

• invalid_expiry_month: Gunakan bulan yang tidak valid, seperti 13.
• invalid_expiry_year: Gunakan setahun hingga 50 tahun yang lalu, seperti 95.
• invalid_cvc: Gunakan dua digit angka, seperti 99.
• incorrect_number: Gunakan nomor kartu yang gagal pemeriksaan Luhn, seperti 4242424242424241
  .

Sengketa

Untuk menyimulasikan transaksi yang dipersengketakan, gunakan kartu percobaan di bagian ini. Kemudian untuk menyimulasikan kemenangan atau kekalahan dalam sengketa tersebut, sediakan bukti menang atau kalah.

Bukti

Untuk menyimulasikan kemenangan atau kekalahan dalam sengketa, tanggapi dengan salah satu nilai bukti dari tabel di bawah ini.

• Jika Anda menanggapi menggunakan API, lewatkan nilai dari tabel sebagai uncategorized_text.
• Jika Anda menanggapi di Dashboard, masukkan nilai dari tabel dalam bidang Informasi tambahan. Kemudian, klik Kirim bukti.

Pengembalian dana

Di mode live, pengembalian dana asinkron: pengembalian dana dapat tampak berhasil dan kemudian gagal, atau dapat muncul sebagai pending pada awalnya dan kemudian berhasil. Untuk menyimulasikan pengembalian dana dengan perilaku tersebut, gunakan kartu percobaan di bagian ini. (Dengan semua kartu percobaan lainnya, pengembalian dana langsung berhasil dan jangan ubah status setelahnya.)

Anda dapat membatalkan pengembalian dana kartu hanya dengan menggunakan Dashboard. Dalam mode live, Anda dapat membatalkan pengembalian dana kartu dalam jangka waktu singkat, tetapi tidak spesifik. Lingkungan percobaan menyimulasikan periode itu dengan memungkinkan Anda membatalkan pengembalian dana kartu dalam waktu 30 menit.

Saldo yang tersedia

Untuk mengirim dana dari transaksi percobaan langsung ke saldo yang tersedia, gunakan kartu percobaan di bagian ini. Kartu percobaan lainnya mengirim dana dari pembayaran yang berhasil ke saldo Anda menunggu.

Autentikasi 3D Secure

3D Secure memerlukan lapisan autentikasi tambahan untuk transaksi kartu kredit. Kartu percobaan di bagian ini memungkinkan Anda menyimulasikan autentikasi pemicu di berbagai alur pembayaran.

Hanya kartu di bagian ini yang secara efektif mencoba integrasi 3D Secure Anda dengan menyimulasikan perilaku 3DS yang ditetapkan, seperti alur tantangan atau kartu yang tidak didukung. Kartu percobaan Stripe lainnya mungkin masih memicu 3DS, tetapi kami mengembalikan attempt_acknowledged untuk melompati langkah tambahan karena percobaan 3DS bukanlah tujuan untuk kartu-kartu tersebut.

Autentikasi dan penyiapan

Untuk menyimulasikan alur pembayaran yang mencakup autentikasi, gunakan kartu percobaan di bagian ini. Beberapa dari kartu ini juga dapat diatur untuk pembayaran di masa mendatang, atau sudah demikian.

Dukungan dan ketersediaan

Stripe meminta autentikasi bila diperlukan oleh regulasi atau ketika dipicu oleh aturan Radar atau kode custom Anda. Sekalipun diminta, autentikasi tidak selalu dapat dilakukan—misalnya, kartu pelanggan mungkin tidak terdaftar, atau terjadi kesalahan. Gunakan kartu percobaan di bagian ini untuk menyimulasikan berbagai kombinasi faktor-faktor ini.

Alur tantangan seluler 3D Secure

Dalam pembayaran seluler, tersedia beberapa alur tantangan untuk autentikasi—yang mengharuskan pelanggan berinteraksi dengan prompt di UI. Gunakan kartu percobaan di bagian ini guna memicu alur tantangan khusus untuk keperluan percobaan. Kartu ini tidak berguna dalam formulir pembayaran berbasis browser atau dalam panggilan API. Di lingkungan itu, kartu tersebut berfungsi tetapi tidak memicu perilaku khusus. Karena tidak berguna dalam panggilan API, kami tidak menyediakan nilai PaymentMethod atau Token untuk dicoba.

Tantangan Captcha

Untuk mencegah penipuan, Stripe mungkin menampilkan tantangan captcha kepada pengguna pada halaman pembayaran. Gunakan kartu percobaan di bawah ini untuk menyimulasikan alur ini.

Pembayaran dengan PIN

Gunakan kartu percobaan pada bagian ini untuk menyimulasikan pembayaran di tempat yang melibatkan PIN. Ada banyak opsi lain untuk mencoba pembayaran di tempat, termasuk simulasi reader dan kartu percobaan fisik. Lihat Coba Stripe Terminal untuk informasi selengkapnya.

Tujuan kejadian

Untuk mencoba endpoint webhook atau tujuan kejadian, pilih salah satu dari dua opsi ini:

1. Lakukan tindakan di sandbox yang mengirim kejadian yang sah ke tujuan kejadian Anda. Misalnya, untuk memicu kejadian charge.succeeded, Anda dapat menggunakan kartu percobaan yang menghasilkan charge yang berhasil.
2. Picu kejadian menggunakan Stripe CLI atau menggunakan Stripe untuk Visual Studio Code.

Batas tingkat

Jika permintaan Anda di lingkungan percobaan mulai menerima kesalahan HTTP 429, kurangi frekuensi permintaannya. Kesalahan ini berasal dari pembatasan laju, yang lebih ketat di lingkungan percobaan dibandingkan dalam mode live.

Kami tidak menyarankan untuk melakukan percobaan beban pada integrasi Anda menggunakan API Stripe di lingkungan percobaan. Karena pembatas beban lebih ketat di lingkungan percobaan, Anda dapat melihat kesalahan yang tidak akan terlihat dalam produksi. Lihat percobaan beban untuk pendekatan alternatif.

Pembayaran nonkartu

Kapan pun Anda menggunakan metode pembayaran nonkartu percobaan, gunakan kunci API percobaan di semua panggilan API. Hal ini berlaku saat Anda menyajikan formulir pembayaran yang dapat Anda coba secara interaktif atau menulis kode percobaan.

Metode pembayaran berbeda memiliki prosedur percobaan berbeda:

Link

Saat ini, Link hanya berfungsi dengan kartu kredit, kartu debit, dan pembelian rekening bank AS yang memenuhi syarat. Link memerlukan pendaftaran domain.

Anda dapat membuat akun sandbox untuk Link menggunakan alamat email yang valid. Tabel berikut menampilkan nilai kode sandi satu kali tetap yang Stripe terima untuk melakukan autentikasi akun sandbox:

Berbagai sumber pendanaan

Saat Stripe menambahkan dukungan sumber pendanaan tambahan, Anda tidak perlu memperbarui integrasi. Stripe secara otomatis mendukungnya dengan waktu penyelesaian transaksi dan jaminan yang sama seperti pembayaran kartu dan rekening bank.

Pengarahan ulang

Untuk mencoba logika penanganan pengalihan integrasi Anda dengan menyimulasikan pembayaran yang menggunakan alur pengalihan (misalnya, iDEAL), gunakan metode pembayaran yang didukung yang memerlukan pengalihan.

Untuk membuat PaymentIntent percobaan yang berhasil atau gagal:

1. Arahkan ke pengaturan metode pembayaran di Dashboard dan aktifkan metode pembayaran yang didukung dengan mengklik Aktifkan di lingkungan percobaan Anda.
2. Kumpulkan detail pembayaran.
3. Serahkan pembayaran ke Stripe.
4. Otorisasi atau gagalkan pembayaran percobaan.

Pastikan bahwa halaman (sesuai dengan return_url) di situs web Anda menyediakan status pembayaran.