Lewati ke konten
Buat akun
 atau
Masuk
Logo Dokumen Stripe
/
Buat akun
Masuk
Gambaran UmumUpgrade integrasi Anda
Pembayaran online
Gambaran umumTemukan contoh penggunaan AndaManaged Payments
Metode Pembayaran
Antarmuka pembayaran
Skenario pembayaran
Pembayaran di tempat
Di luar pembayaran

Terima transfer bank

Gunakan Payment Intents API untuk menerima pembayaran transfer bank.

Pertama kali Anda menerima pembayaran transfer bank dari pelanggan, Stripe membuat rekening bank virtual untuk mereka, yang kemudian dapat Anda bagikan dengan mereka secara langsung. Semua pembayaran transfer bank mendatang dari pelanggan ini akan dikirim ke rekening bank ini. Di sejumlah negara, Stripe juga memberi Anda nomor referensi transfer unik yang harus disertakan pelanggan pada setiap transfer agar mempermudah pencocokan transfer dengan pembayaran terutang. Sejumlah negara memiliki batas jumlah nomor rekening bank virtual yang dapat dibuat secara gratis.

Anda dapat menemukan gambaran umum tentang langkah-langkah umum saat menerima pembayaran transfer bank dalam diagram urutan berikut:

Menangani kurang bayar dan lebih bayar

Dengan pembayaran transfer bank, dimungkinkan pelanggan mengirimi Anda lebih atau kurang dari jumlah pembayaran yang diharapkan. Jika pelanggan mengirim terlalu sedikit, Stripe mendanai sebagian tujuan pembayaran terbuka. Invoice tidak akan didanai sebagian dan tetap terbuka sampai dana yang masuk menutupi jumlah invoice penuh.

Jika pelanggan mengirim lebih dari jumlah yang diharapkan, Stripe mencoba merekonsiliasi dana yang masuk dengan pembayaran terbuka serta menyimpan sisa jumlah kelebihannya di saldo kas pelanggan. Anda dapat menemukan detail selengkapnya tentang cara Stripe menangani rekonsiliasi di bagian rekonsiliasi dari dokumentasi kami.

Ketika pelanggan membayar kurang:

Ketika pelanggan membayar lebih:

Menangani beberapa invoice atau pembayaran terbuka

Anda mungkin memiliki beberapa invoice atau pembayaran terbuka yang dapat dibayar dengan transfer bank. Di penyiapan default, Stripe mencoba untuk secara otomatis merekonsiliasi transfer bank dengan menggunakan informasi seperti kode referensi transfer atau jumlah yang ditransfer.

Anda dapat menonaktifkan rekonsiliasi otomatis serta secara manual merekonsiliasi pembayaran dan invoice sendiri. Anda dapat mengesampingkan perilaku rekonsiliasi otomatis per pelanggan dengan mengatur mode rekonsiliasi ke manual.

Peringatan

Stripe menyajikan opsi metode pembayaran kepada pelanggan Anda dengan mengevaluasi mata uangnya, pembatasan metode pembayaran, dan parameter lainnya. Kami merekomendasikan Anda mengonfigurasi metode pembayaran dari Dashboard Stripe menggunakan petunjuk di Terima pembayaran.

Jika Anda ingin melanjutkan konfigurasi metode pembayaran yang disajikan kepada pelanggan secara manual dengan Checkout, gunakan panduan ini. Jika tidak, perbarui integrasi Anda untuk mengonfigurasi metode pembayaran di Dashboard.

Transfer bank adalah metode pembayaran single-use untuk Checkout yang memungkinkan pelanggan membayar dengan transfer bank menggunakan instruksi pembayaran yang diberikan. Saat memilih membayar, pengguna dialihkan ke halaman yang di-hosting yang menampilkan instruksi transfer bank dan status pembayaran transfer.

Transfer bank juga merupakan metode pembayaran dengan notifikasi tertunda, yang berarti dana tidak langsung tersedia setelah pembayaran.

Peringatan

Transfer bank tidak tersedia pada Sesi Checkout yang tidak menyertakan objek Pelanggan yang sudah ada sebagai bagian dari permintaan pembuatan sesi.

Tentukan kompatibilitas

Sesi Checkout harus memenuhi semua persyaratan berikut untuk mendukung pembayaran Bank Transfer:

  • Prices untuk semua mata anggaran harus dalam mata uang yang sama. Jika Anda memiliki mata anggaran dalam mata uang berbeda, buat Sesi Checkout terpisah untuk setiap mata uang.

  • Anda hanya dapat menggunakan mata anggaran satu kali (Sesi Checkout Transfer Bank tidak mendukung paket langganan rutin).

Terima pembayaran

Catatan

Buat integrasi untuk menerima pembayaran dengan Checkout sebelum menggunakan panduan ini.

Gunakan panduan ini untuk mengaktifkan Bank Transfer.

Buat atau ambil Pelanggan

Anda harus mengaitkan objek Pelanggan untuk merekonsiliasi setiap pembayaran transfer bank. Jika sudah memiliki objek Pelanggan, Anda dapat melewati langkah ini. Jika tidak, buat objek Pelanggan baru.

Command Line
curl -X POST https://api.stripe.com/v1/customers \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

Aktifkan Bank Transfer sebagai metode pembayaran

Saat membuat Sesi Checkout baru, Anda perlu:

  1. Siapkan customer
  2. Tambahkan customer_balance ke daftar payment_method_types
  3. Memastikan semua line_items Anda menggunakan mata uang yang sama
Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d customer=
{{CUSTOMER_ID}}
 \
  -d "line_items[0][price_data][currency]"=usd \
  -d "line_items[0][price_data][product_data][name]"=T-shirt \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][quantity]"=1 \
  -d mode=payment \
  -d "payment_method_types[0]"=card \
  -d "payment_method_types[1]"=customer_balance \
  -d "payment_method_options[customer_balance][funding_type]"=bank_transfer \
  -d "payment_method_options[customer_balance][bank_transfer][type]"=us_bank_transfer \
  --data-urlencode success_url="https://example.com/success" \
  --data-urlencode cancel_url="https://example.com/failure"

Mengarahkan ulang ke halaman instruksi transfer bank yang di-hosting

Catatan

Tidak seperti pembayaran kartu, pelanggan tidak selalu dialihkan ke success_url dengan pembayaran transfer bank.

Setelah berhasil menyerahkan formulir Checkout,

  • Jika pelanggan sudah memiliki saldo yang cukup tinggi untuk menutupi jumlah permintaan, pembayaran langsung berhasil dan pelanggan dialihkan ke success_url.
  • Jika saldo pelanggan tidak cukup tinggi untuk menutupi jumlah permintaan, pelanggan dialihkan ke hosted_instructions_url. Halaman tersebut memiliki instruksi untuk memandu pelanggan Anda menyelesaikan transfer.

Stripe mengizinkan penyesuaian UI yang dilihat pelanggan di halaman Pengaturan Branding. Pengaturan brand berikut dapat diterapkan ke halaman instruksi yang di-hosting:

  • Ikon—gambar brand dan nama umum bisnis Anda
  • Warna brand—digunakan sebagai warna latar belakang

Penuhi pesanan Anda

Karena transfer bank adalah metode pembayaran dengan notifikasi tertunda, Anda perlu menggunakan metode seperti webhook untuk memonitor status pembayaran serta menangani pemenuhan pesanan. Pelajari selengkapnya tentang menyiapkan webhook dan memenuhi pesanan.

Kejadian berikut dikirim ketika status pembayaran berubah:

Nama KejadianKeteranganLangkah berikutnya
checkout.session.completedPelanggan telah berhasil menyerahkan formulir Checkout dan dialihkan ke hosted_instructions_url.Tunggu pelanggan melakukan transfer bank
checkout.session.async_payment_succeededPelanggan telah berhasil melakukan transfer bank. PaymentIntent bertransisi ke succeeded.Penuhi barang atau layanan yang dibeli oleh pelanggan.

Coba integrasi Anda

Anda dapat mencoba integrasi dengan menyimulasikan transfer bank masuk menggunakan API, Dashboard atau versi beta Stripe CLI.

Untuk menyimulasikan transfer bank menggunakan Dashboard di sandbox, buka halaman pelanggan di Dashboard. Pada Metode pembayaran, klik Tambahkan dan pilih Danai saldo kas (hanya percobaan).

Lihat juga

Apakah halaman ini membantu?
YaTidak
Butuh bantuan? Hubungi Tim CS.
Bergabunglah dengan program akses awal kami.
Lihat log perubahan kami.
Ada pertanyaan? Hubungi Bagian Penjualan.
LLM? Baca llms.txt.
Dijalankan oleh Markdoc