Setup Intents API

Gunakan Setup Intents API untuk menyiapkan metode pembayaran bagi pembayaran mendatang. Ini mirip dengan pembayaran, tetapi tidak ada charge yang dibuat. Siapkan metode pembayaran sekarang untuk pembayaran mendatang.

Tujuannya agar kredensial pembayaran disimpan dan dioptimalkan untuk pembayaran di masa mendatang, yang artinya metode pembayaran dikonfigurasi dengan benar untuk segala skenario. Ketika menyiapkan kartu, misalnya, mungkin perlu untuk mengautentikasi pelanggan atau memeriksa validitas kartu dengan bank pelanggan. Stripe memperbarui objek SetupIntent sepanjang proses itu.

Menyimpan dan menggunakan kembali metode pembayaran

Setup Intents API berguna bagi kalangan bisnis yang melakukan onboarding pelanggan tetapi tidak langsung men-charge mereka:

• Perusahaan rental mobil yang mengumpulkan detail metode pembayaran sebelum pelanggan menyewa mobil dan men-charge kartu setelah masa sewa berakhir
• Situs web penggalangan dana yang mengumpulkan detail kartu untuk di-charge di kemudian hari, hanya jika kampanye mencapai jumlah tertentu
• Perusahaan air atau listrik yang men-charge jumlah yang berbeda setiap bulan berdasarkan penggunaan tetapi mengumpulkan detail pembayaran SEPA sebelum pembayaran bulan pertama

Mulai

• Simpan kartu tanpa melakukan pembayaran awal
• Simpan detail bank untuk pembayaran Debit Langsung SEPA
• Simpan detail bank untuk pembayaran Debit Langsung BECS

Mendapatkan izin untuk menyimpan metode pembayaran

Jika Anda menyiapkan metode pembayaran untuk pembayaran di-luar sesi di masa mendatang, Anda memerlukan izin. Pembuatan perjanjian (terkadang disebut kuasa) di awal memungkinkan Anda men-charge pelanggan bila mereka tidak aktif menggunakan situs atau aplikasi Anda.

Tambahkan ketentuan ke situs web atau aplikasi yang menyatakan cara Anda berencana memproses pembayaran, dan biarkan pelanggan ikut serta. Setidaknya, pastikan ketentuan Anda mencakup hal-hal berikut:

• Izin pelanggan kepada Anda untuk memulai pembayaran atau serangkaian pembayaran atas nama mereka
• Frekuensi pembayaran yang diantisipasi (yaitu, satu kali atau rutin)
• Cara jumlah pembayaran akan ditentukan

Lihat teks kuasa yang direkomendasikan untuk menyimpan kartu atau menyimpan detail bank SEPA.

Bagi pengguna yang terdampak oleh SCA, perjanjian ini membantu agar pembayaran berhasil tanpa gangguan. Bila Anda menyiapkan integrasi untuk menyimpan kartu dengan benar, Stripe menandai setiap pembayaran berikutnya di-luar sesi sebagai transaksi yang diprakarsai merchant (MIT) sehingga pelanggan Anda tidak perlu kembali online dan melakukan autentikasi. Transaksi yang diprakarsai merchant memerlukan perjanjian antara Anda dan pelanggan Anda.

Meningkatkan rasio keberhasilan dengan menentukan penggunaan

Parameter penggunaan memberi tahu Stripe cara Anda berencana menggunakan detail metode pembayaran di kemudian hari. Untuk sebagian metode pembayaran, Stripe dapat menggunakan pengaturan usage Anda untuk memilih alur yang paling bebas hambatan bagi pelanggan. Optimisasi ini dirancang untuk meningkatkan jumlah pembayaran yang berhasil.

Misalnya, kartu kredit dan debit berdasarkan regulasi SCA Eropa mungkin mengharuskan pelanggan untuk mengautentikasi kartu selama proses penyimpanan. Pengaturan usage ke off_session mengautentikasi kartu kredit atau debit dengan benar untuk pembayaran di-luar sesi sehingga pelanggan Anda tidak perlu kembali online dan melakukan autentikasi ulang. Jadi, meskipun hal ini menciptakan hambatan awal dalam alur persiapan, pengaturan usage ke off_session dapat mengurangi intervensi pelanggan dalam pembayaran berikutnya di-luar sesi.

Namun, jika Anda hanya berencana menggunakan kartu tersebut bila pelanggan melakukan checkout, atur usage ke on_session. Hal ini memberi tahu bank bahwa Anda berencana menggunakan kartu tersebut bila pelanggan dapat mengautentikasi, sehingga Anda dapat menunda autentikasi detail kartu untuk saat ini dan menghindari hambatan di awal.

Usage merupakan optimisasi. Anda tetap dapat menggunakan kartu yang disiapkan untuk pembayaran di-dalam sesi untuk melakukan pembayaran di-luar sesi, tetapi bank lebih cenderung menolak pembayaran di-luar sesi dan mengharuskan autentikasi dari pelanggan. Kedua kasus itu mungkin masih memerlukan autentikasi di kemudian hari, jadi buat proses pemulihan di aplikasi Anda. Bila pembayaran kartu di-luar sesi memerlukan autentikasi, jadikan pelanggan Anda kembali online untuk menyelesaikan pembayaran.

Jika tidak ditentukan, usage default ke off_session. Lihat cara membuat SetupIntent di server Anda dan tentukan usage:

curl https://api.stripe.com/v1/setup_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d usage=on_session