Sources APITidak lagi digunakan

Source objects allow you to accept a variety of payment methods with a single API. A source represents a customer’s payment method, and you can use it with the Stripe API to create payments. You can charge sources directly, or attach them to customers for later reuse.

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:

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 ada tindakan pelanggan

Alur pengalihan

Alur verifikasi kode

Alur penerima

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 Pelanggan untuk digunakan kembali. (Jika di-charge secara langsung, statusnya akan berubah menjadi consumed.) Untuk mempelajari cara melampirkan Sumber ke Pelanggan, serta untuk mengelola daftar sumber Pelanggan, lihat panduan Sumber dan Pelanggan.

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 keberhasilan pembayaran. 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.