Pengujian

Untuk menguji integrasi Anda, lakukan simulasi transaksi tanpa memindahkan dana dengan menggunakan nilai uji khusus di sandbox. Anda dapat mengakses sandbox melalui pemilih akun di kanan atas halaman atau di Dashboard.

Kartu uji berfungsi sebagai kartu kredit palsu dan memungkinkan Anda mensimulasikan 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

Pengujian pembayaran non-kartu bekerja dengan cara yang serupa. Pembayaran non-kartu adalah metode pembayaran yang bukan kartu kredit maupun debit. Stripe mendukung berbagai opsi pembayaran non-kartu, seperti dompet digital dan transfer bank. Setiap metode pembayaran memiliki nilai khusus 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 uji, gunakan kunci API tes dalam semua panggilan API. Hal ini berlaku baik saat Anda menyajikan formulir pembayaran untuk diuji secara interaktif maupun saat menulis kode uji.

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.

Menguji formulir secara interaktif dengan nomor kartu uji 4242 4242 4242 4242

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

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

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.

Kartu berdasarkan brand

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

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.

Kartu berdasarkan negara

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

Kartu uji HSA dan FSA

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

Pembayaran yang ditolak

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

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.

Data 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
  .

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.

Pengembalian dana

Dalam mode live, pengembalian dana bersifat asinkron: pengembalian dapat terlihat berhasil namun kemudian gagal, atau awalnya tampak tertunda lalu berhasil. Untuk mensimulasikan pengembalian dengan perilaku tersebut, gunakan kartu uji pada bagian ini. (Dengan kartu uji lainnya, pengembalian dana langsung berhasil dan statusnya tidak berubah setelah itu.)

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.

Saldo 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.

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.

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.

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.

Pembayaran 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.

Tujuan peristiwa

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.

Pembayaran non-kartu

Setiap kali Anda menggunakan metode pembayaran uji non-kartu, 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:

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 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 pengujian 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.