Pembayaran kartu di Charges APITidak lagi digunakan
API terdahulu
Isi bagian ini mengacu pada fitur Legacy. Gunakan PaymentIntents API sebagai gantinya.
Charges API tidak mendukung fitur berikut, banyak di antaranya diperlukan untuk kepatuhan kartu kredit:
Charge dan Token API adalah API terdahulu yang digunakan dalam integrasi Stripe lama untuk menerima pembayaran kartu debit dan kredit. Gunakan PaymentIntents untuk integrasi baru.
Charges API membatasi kemampuan Anda untuk memanfaatkan fitur-fitur Stripe. Untuk mendapatkan fitur terbaru, gunakan Stripe Checkout atau migrasi ke Payment Intents API.
Alur pembayaran
Dalam kebanyakan kasus, PaymentIntents API menawarkan lebih banyak fleksibilitas dan opsi integrasi.
Charges API | Payment Intents API |
---|---|
|
|
Pengembalian dana
Untuk mengembalikan pembayaran menggunakan API, buat Pengembalian Dana dan berikan identifikasi charge yang akan dikembalikan dananya.
Untuk mengembalikan sebagian dana pembayaran, berikan parameter amount
, berupa bilangan bulat dalam sen (atau satuan mata uang terkecil dari mata uang charge).
Apple Pay
Bila pelanggan Anda menerima pembayaran, aplikasi Anda akan menerima instance PKPayment berisi detail kartu terenkripsi mereka dengan mengimplementasikan berbagai metode PKPaymentAuthorizationViewControllerDelegate.
- Gunakan metode SDK createTokenWithPayment untuk mengubah
PKPayment
menjadiToken
Stripe - Gunakan
Token
ini untuk membuat charge.
Keterangan rekening koran dinamis
Secara default, keterangan rekening koran akun Stripe Anda ditampilkan di rekening koran pelanggan setiap kali Anda men-charge kartu mereka. Selain itu, Anda dapat mengatur keterangan rekening koran secara dinamis di setiap permintaan charge dengan argumen statement_descriptor
di objek Charge.
Deskriptor pernyataan dibatasi hingga 22 karakter, tidak dapat menggunakan karakter khusus <
, >
, '
, "
, atau *
, dan tidak boleh hanya terdiri dari angka.
Saat mengatur keterangan rekening koran secara dinamis pada charge kartu kredit dan debit, bagian dinamis ditambahkan ke keterangan rekening koran penyelesaian merchant (dipisahkan oleh *
dan spasi kosong). Misalnya, keterangan rekening koran untuk bisnis, bernama FreeCookies, yang menyertakan jenis kukis yang dibeli mungkin terlihat seperti FREECOOKIES* SUGAR
.
*
dan spasi kosong dihitung terhadap batas 22 karakter dan Stripe secara otomatis mengalokasikan 10 karakter untuk keterangan rekening koran dinamis. Artinya, keterangan penyelesaian merchant mungkin terpotong jika lebih dari 10 karakter (dengan asumsi keterangan rekening koran dinamis juga lebih dari 10 karakter). Jika keterangan rekening koran dinamis juga lebih dari 10 karakter, kedua keterangan akan dipotong menjadi 10 karakter.
Jika Anda mengalami masalah dengan batas karakter, Anda dapat mengatur keterangan singkat di Dashboard Stripe untuk mempersingkat keterangan penyelesaian merchant. Ini memungkinkan lebih banyak ruang untuk keterangan rekening koran dinamis. Keterangan singkat:
- Mengganti keterangan rekening koran penyelesaian merchant saat menggunakan keterangan dinamis.
- Bisa antara 2 dan 10 karakter.
Catatan
Jika deskripsi pernyataan akun Anda lebih dari 10 karakter, setel deskriptor singkat di Dashboard atau gunakan statement_descriptor_prefix
. Ini mencegah deskriptor pernyataan Anda terpotong dengan cara yang tidak terduga.
Jika Anda tidak yakin seperti apa keterangan rekening koran itu ketika digabungkan, Anda dapat memeriksanya di Dashboard Stripe.
Menyimpan informasi dalam metadata
Stripe mendukung penambahan metadata ke permintaan paling umum yang Anda buat, seperti pemrosesan charge. Metadata tidak ditampilkan kepada pelanggan atau diperhitungkan apakah charge ditolak atau diblokir oleh sistem pencegahan penipuan kami.
Melalui metadata, Anda dapat mengaitkan informasi lain—yang berarti bagi Anda—dengan aktivitas Stripe. Metadata yang Anda sertakan dapat dilihat di Dashboard (misalnya, saat melihat halaman untuk masing-masing charge), juga tersedia dalam laporan umum dan ekspor. Misalnya, identifikasi pesanan toko Anda dapat dilampirkan pada charge yang digunakan untuk membayar pesanan itu. Dengan melakukan hal itu memungkinkan Anda, akuntan, atau tim keuangan Anda merekonsiliasikan charge dengan mudah di Stripe untuk pesanan di sistem.
Jika Anda menggunakan Radar, pertimbangkan penerusan informasi pelanggan tambahan dan informasi pesanan sebagai metadata. Dengan melakukan hal itu, Anda dapat menulis aturan Radar menggunakan atribut metadata dan memiliki informasi selengkapnya tentang pembayaran yang tersedia di Dashboard yang dapat mempercepat proses peninjauan Anda.
Peringatan
Jangan menyimpan informasi sensitif (informasi yang dapat mengenali pribadi, detail kartu, dan lain-lain) sebagai metadata atau dalam parameter description
charge.
Penolakan
Jika ingin integrasi merespons kegagalan pembayaran secara otomatis, Anda dapat mengakses outcome
charge dengan dua cara.
- Tangani kesalahan API yang dikembalikan bila pembayaran gagal. Untuk pembayaran yang diblokir dan ditolak oleh penerbit kartu, kesalahannya mencakup identifikasi charge, yang kemudian dapat Anda gunakan untuk mengambil charge tersebut.
- Gunakan webhook untuk memantau pembaruan status. Misalnya, kejadian
charge.failed
terpicu saat pembayaran tidak berhasil.