# Setup Intents API

Pelajari selengkapnya tentang Setup Intents API untuk menyimpan metode pembayaran.

Gunakan *Setup Intents API* (The Setup Intents API lets you build dynamic flows for collecting payment method details for future payments. It tracks the lifecycle of a payment setup flow and can trigger additional authentication steps if required by law or by the payment method) untuk menyiapkan metode pembayaran bagi pembayaran mendatang. Ini mirip dengan pembayaran, tetapi tidak ada charge yang dibuat. [Siapkan metode pembayaran sekarang untuk pembayaran mendatang](https://docs.stripe.com/payments/save-and-reuse.md).

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

> Anda juga dapat menyiapkan metode pembayaran untuk digunakan di masa mendatang saat Anda men-charge selama [Checkout](https://docs.stripe.com/payments/save-and-reuse.md?platform=checkout).

#### Mulai

- [Simpan kartu tanpa melakukan pembayaran awal](https://docs.stripe.com/payments/save-and-reuse.md)
- [Simpan detail bank untuk pembayaran Debit Langsung SEPA](https://docs.stripe.com/payments/sepa-debit/set-up-payment.md)
- [Simpan detail bank untuk pembayaran Debit Langsung BECS](https://docs.stripe.com/payments/au-becs-debit/set-up-payment.md)

## Dapatkan izin untuk menyimpan metode pembayaran

Anda bertanggung jawab untuk kepatuhan terhadap semua hukum, peraturan, dan aturan jaringan yang berlaku saat menyimpan detail pembayaran pelanggan.

### Penggunaan di-dalam sesi di masa mendatang

Jika Anda menyiapkan metode pembayaran untuk pembayaran *on-session* (A payment is described as on-session if it occurs while the customer is actively in your checkout flow and able to authenticate the payment method) mendatang, seperti menampilkan metode pembayaran pada halaman checkout mendatang, Anda harus secara eksplisit meminta persetujuan dari pelanggan untuk penggunaan spesifik ini. Misalnya, sertakan kotak centang “Simpan metode pembayaran saya untuk penggunaan mendatang” untuk memungut persetujuan.

Jika Anda perlu membedakan metode pembayaran yang disimpan hanya untuk penggunaan offline dan metode pembayaran yang dapat Anda tampilkan kepada pelanggan untuk pembelian *di-dalam sesi* (A payment is described as on-session if it occurs while the customer is actively in your checkout flow and able to authenticate the payment method) mendatang, Anda dapat menggunakan parameter [allow_redisplay](https://docs.stripe.com/api/payment_methods/object.md#payment_method_object-allow_redisplay) pada objek PaymentMethod.

### Penggunaan di luar sesi mendatang

Jika Anda menyiapkan metode pembayaran untuk pembayaran *di-luar sesi* (A payment is described as off-session if it occurs without the direct involvement of the customer, using previously-collected payment information) 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](https://docs.stripe.com/payments/save-and-reuse.md?platform=web&ui=elements#collect-payment-details) atau [menyimpan detail bank SEPA](https://docs.stripe.com/payments/sepa-debit/set-up-payment.md).

Bagi pengguna yang terdampak oleh *SCA* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase), 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* (A payment made off-session with a properly authenticated saved card, can qualify as merchant-initiated transaction and be exempt from SCA) (MIT) sehingga pelanggan Anda tidak perlu kembali online dan melakukan autentikasi. Transaksi yang diprakarsai merchant memerlukan perjanjian antara Anda dan pelanggan Anda.

## Tentukan penggunaan untuk meningkatkan rasio keberhasilan

Parameter [penggunaan](https://docs.stripe.com/api/setup_intents/object.md#setup_intent_object-usage) 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* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase) 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.

| Cara yang Anda inginkan untuk menggunakan kartu                                                                                                                                       | nilai enumerasi usage untuk digunakan |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------- |
| Hanya pembayaran *di-dalam sesi* (A payment is described as on-session if it occurs while the customer is actively in your checkout flow and able to authenticate the payment method) | `on_session`                          |
| Hanya pembayaran *di-luar sesi* (A payment is described as off-session if it occurs without the direct involvement of the customer, using previously-collected payment information)   | `off_session` (default)               |
| Pembayaran di-dalam maupun di-luar sesi                                                                                                                                               | `off_session` (default)               |

`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](https://docs.stripe.com/billing/revenue-recovery.md) 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
curl https://api.stripe.com/v1/setup_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d usage=on_session
```

> Ikuti panduan di halaman ini untuk memastikan integrasi Anda menangani kartu yang memerlukan *Autentikasi Pelanggan yang Kuat* (Strong Customer Authentication (SCA) is a regulatory requirement in effect as of September 14, 2019, that impacts many European online payments. It requires customers to use two-factor authentication like 3D Secure to verify their purchase). Penandaan transaksi dengan benar memungkinkan Stripe mengeklaim pembebasan SCA yang benar atas nama Anda untuk meminimalkan kebutuhan autentikasi dengan setiap pembayaran.