Pengujian

Coba integrasi Anda di Sandbox dengan menyimulasikan transaksi dengan nilai percobaan—transaksi ini tidak memindahkan dana.

Anda dapat mengakses sandbox menggunakan pemilih akun di Dashboard.

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

• Pembayaran berhasil dengan merek kartu atau negara
• Kesalahan kartu akibat penolakan, penipuan, atau data tidak valid
• Sengketa dan pengembalian dana
• Autentikasikan dengan 3D Secure dan PIN

Pembayaran nonkartu juga dapat dicoba di sandbox. Pembayaran nonkartu adalah metode pembayaran yang tidak menggunakan kartu kredit atau debit. Stripe mendukung berbagai opsi pembayaran nonkartu, seperti dompet digital dan transfer bank. Setiap metode pembayaran memiliki nilai tersendiri.

Jangan gunakan lingkungan pengujian untuk melakukan pengujian beban pada integrasi Anda karena dapat mencapai batas kecepatan. Untuk melakukan pengujian beban pada integrasi, lihat pengujian beban.

Cara menggunakan kartu percobaan

Setiap kali Anda bekerja dengan kartu percobaan, gunakan kunci API percobaan dalam semua panggilan API. Hal ini berlaku baik saat Anda menyajikan formulir pembayaran untuk diuji secara interaktif maupun saat menulis kode percobaan.

Pengujian interaktif

Saat melakukan pengujian interaktif, gunakan nomor kartu seperti 4242 4242 4242 4242 4242. Masukkan nomor kartu tersebut di Dashboard atau di formulir pembayaran mana pun.

• Gunakan tanggal mendatang yang valid, seperti 12/34.
• Gunakan CVC tiga digit apa pun (empat digit untuk kartu American Express).
• Gunakan nilai apa pun yang Anda inginkan untuk kolom formulir lainnya.

Kode percobaan

Saat menulis kode uji, gunakan PaymentMethod seperti pm_card_visa sebagai pengganti nomor kartu. Kami tidak merekomendasikan penggunaan nomor kartu secara langsung dalam panggilan API atau kode sisi server, bahkan di lingkungan pengujian. Jika Anda tetap menggunakannya, kode Anda mungkin tidak sesuai dengan standar PCI ketika dijalankan di mode live. Secara default, PaymentMethod tidak dilampirkan pada Customer.

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

Saat Anda siap untuk menjalankan integrasi secara nyata, ganti kunci API publik dan rahasia uji dengan yang langsung (live). Anda tidak dapat memproses pembayaran nyata jika integrasi Anda masih menggunakan Kunci API uji.

Simulasikan pembayaran menurut merek kartu

Untuk menyimulasikan pembayaran yang berhasil untuk merek kartu tertentu, gunakan kartu uji dari daftar berikut.

Biaya lintas batas ditetapkan berdasarkan negara penerbit kartu. Kartu dengan negara penerbit selain AS (seperti JCB dan UnionPay) dapat dikenakan biaya lintas batas, bahkan di lingkungan pengujian.

Sebagian besar kartu Cartes Bancaires dan eftpos merupakan kartu co-brand dengan Visa atau Mastercard. Kartu uji pada tabel berikut mensimulasikan pembayaran yang berhasil dengan kartu co-brand.

Simulasikan pembayaran menurut negara

Untuk menyimulasikan pembayaran yang berhasil dari negara tertentu, gunakan kartu uji dari bagian berikut.

Simulasikan pembayaran kartu HSA atau FSA

Di bawah ini adalah nomor kartu percobaan untuk menyimulasikan transaksi menggunakan Rekening Tabungan Kesehatan (HSA) dan Rekening Pengeluaran Fleksibel (FSA). Akun ini umumnya digunakan untuk pengeluaran medis, dan dengan menggunakannya dalam percobaan memastikan penanganan transaksi terkait layanan kesehatan dalam aplikasi Anda dilakukan dengan benar.

Simulasikan pembayaran yang ditolak

Untuk menguji logika penanganan kesalahan integrasi Anda dengan menyimulasikan pembayaran yang ditolak penerbit karena berbagai alasan, gunakan kartu percobaan dari bagian ini. Menggunakan kartu ini akan menghasilkan kartu kesalahan kartu dengan kode kesalahan dan kode penolakan yang ditentukan.

Berikan CVC saat Anda menguji perilaku CVC. Stripe akan melewatkan pemeriksaan CVC jika Anda tidak menyertakannya, sehingga pemeriksaan tidak akan menghasilkan status gagal. Untuk menyimulasikan CVC yang salah, gunakan kartu percobaan “Kesalahan CVC gagal” yang tercantum dalam tabel berikut dan berikan CVC tiga angka.

Pencegahan penipuan

Sistem pencegahan penipuan Stripe, Radar, dapat memblokir pembayaran ketika memiliki tingkat risiko tinggi atau gagal dalam pemeriksaan verifikasi. Anda dapat menggunakan kartu pada bagian ini untuk menguji pengaturan Radar Anda. Anda juga dapat menggunakannya untuk menguji bagaimana integrasi Anda merespons pembayaran yang diblokir.

Setiap kartu mensimulasikan faktor risiko tertentu. Pengaturan Radar Anda menentukan faktor risiko mana yang menyebabkan pembayaran diblokir. Pembayaran yang diblokir akan menghasilkan kesalahan kartu dengan kode kesalahan fraud.

Untuk memicu pemeriksaan CVC yang gagal, sertakan CVC (nomor tiga digit apa pun). Untuk memicu pemeriksaan kode pos yang gagal, sertakan kode pos yang valid. Jika Anda melewatkan bidang-bidang ini, Radar akan melewatkan pemeriksaan tersebut, sehingga mereka tidak akan menghasilkan status gagal.

Memicu kesalahan dengan data yang tidak valid

Untuk menguji error yang dihasilkan dari data tidak valid, berikan detail yang tidak valid. Anda tidak memerlukan kartu uji khusus untuk ini. Nilai tidak valid apa pun bisa digunakan. Misalnya:

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

Simulasikan sengketa

Untuk mensimulasikan transaksi yang disengketakan, gunakan kartu uji pada bagian ini. Lalu, untuk mensimulasikan menang atau kalah dalam sengketa, berikan bukti kemenangan atau kekalahan.

Bukti

Untuk menyimulasikan menang atau kalah dalam sengketa, berikan salah satu nilai bukti dari tabel di bawah ini.

• Jika Anda merespons menggunakan API, teruskan nilai dari tabel sebagai uncategorized_text.
• Jika Anda merespons di Dashboard atau di komponen yang tertanam di Connect, masukkan nilai dari tabel di kolom Informasi Tambahan. Kemudian, klik Kirim bukti.

Simulasikan pengembalian dana asinkron

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 hanya dapat membatalkan pengembalian dana kartu melalui Dashboard. Dalam mode live, Anda dapat membatalkan pengembalian dana kartu dalam jangka waktu singkat namun tidak spesifik. Lingkungan pengujian mensimulasikan jangka waktu tersebut dengan memungkinkan Anda membatalkan pengembalian dana kartu dalam 30 menit.

Kirim dana ke saldo Anda yang tersedia

Untuk mengirim dana dari transaksi uji langsung ke saldo tersedia, gunakan kartu uji pada bagian ini. Kartu uji lainnya akan mengirim dana dari pembayaran yang berhasil ke saldo tertunda.

Coba autentikasi 3D Secure

3D Secure memerlukan lapisan autentikasi tambahan untuk transaksi kartu kredit. Kartu uji coba pada bagian ini memungkinkan Anda mensimulasikan pemicu autentikasi dalam berbagai alur pembayaran.

Hanya kartu pada bagian ini yang secara efektif menguji integrasi 3D Secure Anda dengan mensimulasikan perilaku 3DS yang telah ditentukan, seperti challenge flow atau kartu yang tidak didukung. Kartu uji Stripe lainnya mungkin masih memicu 3DS, tetapi kami mengembalikan attempt_acknowledged untuk melewati langkah tambahan karena pengujian 3DS bukanlah tujuan dari kartu-kartu tersebut.

Autentikasi dan penyiapan

Untuk mensimulasikan alur pembayaran yang mencakup autentikasi, gunakan kartu uji coba pada bagian ini. Beberapa kartu ini juga dapat disiapkan untuk pembayaran di masa mendatang, atau sudah disiapkan sebelumnya.

Dukungan dan ketersediaan

Stripe meminta autentikasi ketika diwajibkan oleh regulasi atau ketika dipicu oleh aturan Radar atau kode khusus Anda. Meskipun autentikasi diminta, proses tersebut tidak selalu dapat dilakukan—misalnya, kartu pelanggan mungkin tidak terdaftar, atau terjadi kesalahan. Gunakan kartu uji di bagian ini untuk menyimulasikan berbagai kombinasi dari faktor-faktor tersebut.

Semua referensi 3DS menunjukkan 3D Secure 2.

Alur tantangan seluler 3D Secure

Dalam pembayaran seluler, tersedia beberapa alur tantangan untuk autentikasi—di mana pelanggan harus berinteraksi dengan prompt pada antarmuka (UI)—yang dapat digunakan. Gunakan kartu uji coba pada bagian ini untuk memicu alur tantangan tertentu untuk tujuan pengujian. Kartu-kartu ini tidak berguna pada formulir pembayaran berbasis browser atau dalam panggilan API. Pada lingkungan tersebut, kartu tetap berfungsi tetapi tidak memicu perilaku khusus apa pun. Karena tidak berguna dalam panggilan API, kami tidak menyediakan nilai PaymentMethod atau Token untuk diuji.

Simulasikan tantangan captcha

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

Simulasikan pembayaran di tempat dengan PIN

Gunakan kartu uji pada bagian ini untuk mensimulasikan pembayaran langsung yang berhasil dengan penggunaan PIN. Tersedia berbagai opsi lain untuk menguji pembayaran langsung, termasuk pembaca simulasi dan kartu uji fisik. Lihat Test Stripe Terminal untuk informasi lebih lanjut.

Coba webhook atau 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 permintaan

Jika permintaan Anda di lingkungan pengujian mulai menerima error HTTP 429, kurangi frekuensinya. Error ini berasal dari pembatas permintaan kami, yang lebih ketat di lingkungan pengujian dibandingkan di mode live.

Kami tidak merekomendasikan melakukan load testing pada integrasi Anda menggunakan Stripe API di lingkungan pengujian. Karena pembatas beban lebih ketat di lingkungan pengujian, Anda mungkin akan melihat error yang tidak akan muncul di lingkungan produksi. Lihat bagian load testing untuk pendekatan alternatif.

Coba metode pembayaran nonkartu

Setiap kali Anda menggunakan metode pembayaran nonkartu, gunakan kunci API uji di semua panggilan API. Hal ini berlaku baik saat Anda menampilkan formulir pembayaran untuk diuji secara interaktif maupun saat menulis kode uji.

Metode pembayaran berbeda memiliki prosedur percobaan berbeda:

Coba tautan

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.

Coba alur berbasis pengalihan

Untuk menguji logika penanganan pengalihan dalam integrasi Anda dengan mensimulasikan pembayaran yang menggunakan redirect flow (misalnya, iDEAL), gunakan metode pembayaran yang didukung dan memerlukan pengalihan.

Untuk membuat PaymentIntent uji yang dapat berhasil atau gagal:

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

Pastikan halaman (yang sesuai dengan return_url) di situs web Anda menampilkan status pembayaran.