Sumber dan pelangganTidak lagi digunakan
Peringatan
Kami tidak lagi menggunakan Sources API dan berencana menghapus dukungan bagi metode pembayaran lokal. Jika saat ini Anda menangani metode pembayaran lokal menggunakan Sources API, Anda harus memigrasikannya ke Payment Methods API. Kami akan mengirimkan komunikasi email dengan informasi selengkapnya tentang akhir dukungan ini.
Meski kami tidak berencana menghapus dukungan untuk pembayaran kartu, kami merekomendasikan Anda mengganti penggunaan Sources API dengan PaymentMethods API, yang memberikan akses ke tipe metode pembayaran dan fitur terbaru kami.
Objek Source dapat berupa sekali pakai atau dapat digunakan kembali, seperti yang ditunjukkan oleh parameter usage
-nya. Walaupun sumber dapat di-charge secara langsung, sumber reusable harus selalu dilampirkan pada objek Customer untuk digunakan kembali nanti. Melampirkan sumber yang dapat digunakan kembali ke objek Customer
memungkinkan Anda menyajikan daftar metode pembayaran yang dapat digunakan kembali kepada pelanggan yang sebelumnya telah mereka gunakan bersama aplikasi atau situs Anda.
Sumber yang dapat digunakan kembali
Metode pembayaran tertentu (misalnya, Debit Langsung SEPA) mendukung sumber yang dapat digunakan kembali, sehingga Anda dapat melakukan pembayaran tambahan tanpa pelanggan perlu menyelesaikan proses pembayaran lagi. Sumber yang dapat Anda gunakan kembali memiliki parameter usage
yang diatur ke reusable
.
Anda harus melampirkan sumber yang dapat digunakan kembali ke objek Customer
sebelum membuat permintaan charge. Jika Anda men-charge sumber yang dapat digunakan kembali tanpa terlebih dahulu melampirkannya, sumber tersebut akan terpakai (statusnya berubah dari chargeable
menjadi consumed
). Sumber yang terpakai tidak dapat digunakan untuk pembayaran lebih lanjut.
Melampirkan sumber ke objek Customer baru
Anda dapat membuat objek Customer
dan melampirkan sumber dalam satu panggilan API. Ini berguna jika baru pertama kali Anda melihat pelanggan ini.
Sumber menjadi sumber default objek Customer
, karena ini adalah metode pembayaran pertama dan satu-satunya pelanggan. Sumber default secara otomatis dipilih jika Anda membuat permintaan charge menggunakan parameter customer
tanpa menentukan source
.
Melampirkan Source ke objek Customer yang ada
Saat Anda memperbarui objek Customer
yang memiliki sumber default, sumber yang ada secara otomatis dilepaskan, dan menambahkan sumber yang disediakan sebagai default baru. Untuk menambahkan sumber tanpa mengganti default yang ada, gunakan metode attach, seperti ditunjukkan di bawah ini.
Di sini, karena mungkin sudah ada sumber default untuk objek Customer
, sumber yang baru dilampirkan tidak menjadi sumber default. Namun, Anda dapat mengubah sumber default dengan memperbarui objek Customer
dan menentukan sumber sebagai nilai untuk default_source
.
Men-charge sumber yang dilampirkan
Anda harus menentukan objek Customer
dan sumber saat membuat permintaan charge.
Jika Anda mencoba men-charge objek Customer
tanpa menentukan sumber, Stripe akan menggunakan sumber default pelanggan.
Melepaskan sumber
Jika Anda perlu menghapus sumber dari objek Customer
tertentu, Anda dapat melepaskan sumber. Melakukannya akan mengubah status sumber menjadi consumed
, sehingga tidak dapat digunakan setelah dilepas.
Sumber sekali pakai
Sumber sekali pakai harus dibuat setiap kali pelanggan melakukan pembayaran, dan tidak dapat digunakan kembali. Karena itu, kami tidak merekomendasikan Anda melampirkannya secara permanen ke pelanggan.
Jika Anda ingin mengaitkan pembayaran dengan objek Customer
tertentu, Anda bisa memasukkan parameter customer
saat membuat permintaan charge bersama sumber, meskipun sumber tidak dilampirkan.
Objek Charge
yang dihasilkan mereferensikan objek Customer
dan Source
, bahkan jika tidak saling berhubungan langsung.