Sumber dan pelangganTidak lagi digunakan

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.

curl https://api.stripe.com/v1/customers \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  --data-urlencode email="paying.user@example.com" \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

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.

curl https://api.stripe.com/v1/customers/cus_AFGbOSiITuJVDs/sources \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d "source"="src_18eYalAHEMiOZZp1l9ZTjSU0"

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.

curl https://api.stripe.com/v1/customers/cus_AFGbOSiITuJVDs \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d default_source=src_18eYalAHEMiOZZp1l9ZTjSU0

Men-charge sumber yang dilampirkan

Anda harus menentukan objek Customer dan sumber saat membuat permintaan charge.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d amount="1099" \
  -d currency="eur" \
  -d customer=cus_AFGbOSiITuJVDs \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

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.

curl https://api.stripe.com/v1/charges \
  -u 
sk_test_4eC39HqLyjWDarjtT1zdp7dc
: \
  -d amount="1099" \
  -d currency="eur" \
  -d customer=cus_AFGbOSiITuJVDs \
  -d source=src_18eYalAHEMiOZZp1l9ZTjSU0

Objek Charge yang dihasilkan mereferensikan objek Customer dan Source, bahkan jika tidak saling berhubungan langsung.