Sources APITidak lagi digunakan

Pelajari tentang berbagai mekanisme dan metode pembayaran yang tersedia melalui Sources API.

Peringatan

We deprecated the Sources API and plan to remove support for local payment methods. If you currently handle any local payment methods using the Sources API, you must migrate them to the Payment Methods API.

While we don’t plan to remove support for card payments, we recommend replacing any use of the Sources API with the PaymentMethods API, which provides access to our latest features and payment method types.

Objek Source memungkinkan Anda menerima berbagai metode pembayaran dengan satu API. Source mewakili instrumen pembayaran pelanggan, dan dapat digunakan bersama API Stripe untuk melakukan pembayaran. Source dapat di-charge secara langsung, atau dilampirkan ke pelanggan untuk digunakan kembali nanti.

Setiap metode pembayaran yang didukung oleh Sources API didefinisikan oleh empat karakteristik utama. Kombinasi karakteristik ini menentukan bagaimana membuat sumber dapat di-charge, dan bagaimana menggunakannya dalam permintaan charge untuk menyelesaikan pembayaran.

Tarik atau dorong: Cara mentransfer dana untuk metode pembayaran dari pelanggan Anda
Alur: Tipe tindakan yang harus dilakukan pelanggan Anda untuk mengautentikasi pembayaran
Penggunaan: Apakah Source dapat digunakan kembali atau tidak
Sinkron atau asinkron: Apakah charge yang dihasilkan dapat segera dikonfirmasi, atau hanya setelah selang waktu tertentu

Untuk contoh lengkap yang menggambarkan cara menyetujui metode pembayaran menggunakan Sources API, lihat contoh toko e-commerce, dan jelajahi kode sumbernya di GitHub.

Metode pembayaran yang didukung

Anda dapat mengaktifkan metode pembayaran yang tersedia untuk Anda di Dashboard. Aktivasi biasanya terjadi seketika, dan tidak memerlukan kontrak tambahan atau menyertakan proses yang panjang. Untuk daftar mendetail, lihat metode pembayaran yang tersedia dan wilayah geografis yang didukung.

Tabel berikut memetakan karakteristik utama yang disebutkan di atas ke metode pembayaran yang didukung:

Transfer	Konfirmasi	Tidak ada	Alihkan	Verifikasi kode	Penerima
Tarik	Sinkron	Kartu	—	—	—
Tarik	Asinkron	Debit Langsung SEPA (Tidak lagi digunakan)	Debit ACH dengan autentikasi	Debit ACH dengan mikrodeposit	—
Dorong	Sinkron	Alipay (Tidak lagi digunakan) Bancontact (Tidak lagi digunakan) giropay (Tidak lagi digunakan) iDEAL (Tidak lagi digunakan) Przelewy24 (Tidak lagi digunakan) WeChat Pay (Tidak lagi digunakan)	—	—	Multibanco (Tidak lagi digunakan)
Dorong	Asinkron	—	Sofort dengan Sources (Tidak lagi digunakan)	—	—

Penarikan atau pendorongan dana

Setiap metode pembayaran dikategorikan sebagai tarik atau dorong, tergantung cara mentransfer dana dari metode pembayaran pelanggan.

Dengan metode tarik, Anda mendebit dana dari akun pelanggan setelah pelanggan memberikan persetujuan. Pembayaran kartu adalah contoh metode tarik: kartu pelanggan Anda didebit saat pembayaran dilakukan, dan tidak perlu interaksi pelanggan untuk debit berikutnya.
Dengan metode dorong, pelanggan mengirimkan dana kepada Anda. Transfer Kredit ACH adalah contoh metode dorong: Pelanggan Anda diberikan nomor rekening dan nomor routing bank yang harus mereka kirim (dorong) dengan jumlah yang benar. Setelah konfirmasi bahwa pelanggan mengirimkan dana kepada Anda, sumber menjadi dapat ditagih, dan siap digunakan dalam permintaan charge. Metode pembayaran dorong lainnya, seperti iDEAL atau Sofort, mengandalkan pengalihan bagi pelanggan Anda untuk mendorong uang kepada Anda, langsung dari rekening bank online mereka. Umumnya, metode dorong memerlukan interaksi pelanggan untuk setiap pembayaran.

Alur untuk tindakan pelanggan

Metode pembayaran tertentu mengharuskan pelanggan Anda menyelesaikan tindakan (alur) tertentu agar sumber dapat di-charge. Tipe alur yang diterapkan ke metode pembayaran dinyatakan dalam parameter flow objek Source. Setiap metode dikategorikan ke dalam salah satu tipe alur berikut.

Tidak perlu tindakan dari pelanggan Anda. Beberapa metode pembayaran (umumnya metode tarik), seperti kartu (tidak termasuk 3D Secure), tidak memerlukan autentikasi tambahan selain mengumpulkan informasi pembayaran dari pelanggan. Sumber yang mewakili metode pembayaran ini dapat digunakan segera saat membuat permintaan charge.

Setelah alur yang diperlukan diselesaikan dan sumber menjadi dapat di-charge, sumber tersebut harus digunakan untuk membuat permintaan charge agar pembayaran selesai. Jika tidak, sumber akan dibatalkan dan pembayaran terautentikasi pelanggan dikembalikan secara otomatis—tidak ada uang yang dipindahkan ke akun Anda.

Sekali pakai atau dapat digunakan kembali

Metode pembayaran tertentu mengizinkan pembuatan sumber yang dapat digunakan kembali untuk pembayaran tambahan tanpa mengharuskan pelanggan menyelesaikan proses pembayaran lagi. Sumber yang dapat digunakan kembali memiliki parameter usage yang diatur ke reusable.

Sebaliknya, jika sumber hanya dapat digunakan sekali, parameter ini diatur ke single_use, dan sumber harus dibuat setiap kali pelanggan melakukan pembayaran. Sumber semacam itu tidak boleh dilampirkan ke pelanggan—sebagai gantinya, sumber harus di-charge secara langsung. Sumber hanya dapat di-charge sekali, dan statusnya akan berubah menjadi consumed saat di-charge.

Sumber yang dapat digunakan kembali harus dilampirkan ke Customer untuk digunakan kembali. (Jika di-charge secara langsung, statusnya akan berubah menjadi consumed.) Untuk mempelajari cara melampirkan Source ke Pelanggan, dan untuk mengelola daftar sumber Customer, lihat panduan Source dan Customer.

Konfirmasi sinkron atau asinkron

Setelah Anda menggunakan metode pembayaran untuk membuat objek Charge, status charge itu dapat dikonfirmasi baik segera (sinkron), atau setelah jangka waktu tertentu (asinkron).

Dengan metode pembayaran sinkron, status permintaan charge dapat langsung dikonfirmasi sebagai succeeded atau failed. Jika permintaan charge berhasil, pembayaran selesai—ini dianggap dijamin bahwa pelanggan telah di-charge, dan Anda akan menerima dana. Pembayaran kartu adalah contoh metode pembayaran sinkron: ada konfirmasi aktual tentang keberhasilan atau kegagalan pembayaran.
Untuk metode pembayaran asinkron, perlu waktu hingga beberapa hari untuk mengonfirmasi apakah pembayaran berhasil atau tidak. Selama itu, pembayaran tidak dapat dijamin. Status objek Charge pembayaran awalnya diatur ke pending, hingga pembayaran dikonfirmasi berhasil atau gagal. Debit ACH adalah contoh metode asinkron: dengan debit ini, perlu waktu beberapa hari untuk mengonfirmasi bahwa pembayaran telah berhasil.

Stripe mengirim kejadian webhook setelah status charge berubah. Saat menerima metode pembayaran asinkron, integrasi Anda harus dapat menerima webhook, sehingga dapat menerima notifikasi ini dan mengonfirmasi apakah pembayaran pelanggan berhasil atau gagal.