Lewati ke konten
Buat akun
 atau
Masuk
Logo Dokumen Stripe
/
Buat akun
Masuk
Gambaran UmumUpgrade integrasi Anda
Pembayaran online
Gambaran umumTemukan contoh penggunaan AndaPembayaran Terkelola
Metode Pembayaran
Antarmuka pembayaran
Skenario pembayaran
Pembayaran di tempat
Produk Stripe lainnya

Pembayaran Konbini

Gunakan API Payment Intents dan Payment Methods untuk menerima pembayaran melalui Konbini, cara umum untuk melakukan pembayaran melalui minimarket di Jepang.

Salin halaman

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.

Konbini adalah metode pembayaran sekali pakai yang mengharuskan pelanggan mengambil langkah tambahan untuk menyelesaikan pembayarannya. Pelanggan membayar dengan memberikan kode pembayaran, nomor konfirmasi, dan pembayaran tunai di mini market Jepang. Stripe memberi tahu Anda saat pembayaran selesai.

Menentukan kompatibilitas

Sesi Checkout harus memenuhi semua persyaratan berikut untuk mendukung pembayaran Konbini:

  • Harga untuk semua mata anggaran harus dalam mata uang yang sama (JPY).
  • Anda hanya dapat menggunakan mata anggaran satu kali (paket langganan rutin tidak didukung).

Menerima pembayaran

Catatan

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

Gunakan panduan ini untuk mempelajari cara mengaktifkan Konbini—ini menunjukkan perbedaan antara menerima pembayaran dengan kartu dan menggunakan Konbini.

Aktifkan Konbini sebagai metode pembayaran

Saat membuat Sesi Checkout baru, Anda perlu:

  1. Tambahkan konbini ke daftar payment_method_types
  2. Pastikan semua line_items Anda menggunakan mata uang jpy.
Command Line
curl https://api.stripe.com/v1/checkout/sessions \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "mode"="payment" \
  -d "payment_method_types[]"="card" \
  -d "payment_method_types[]"="konbini" \
  -d "payment_method_options[konbini][expires_after_days]"=3 \
  -d "line_items[0][price_data][currency]"="jpy" \
  -d "line_items[0][price_data][unit_amount]"=2000 \
  -d "line_items[0][price_data][product_data][name]"="Tシャツ" \
  -d "line_items[0][quantity]"=1 \
  -d "success_url"="https://example.com/success" \
  -d "cancel_url"="https://example.com/cancel"

Opsi metode pembayaran tambahan

Opsi metode pembayaran dapat ditentukan di opsi metode pembayaran pada kunci konbini.

BidangNilaiDiperlukanNilai Default
expires_after_daysJumlah hari kalender sebelum pembayaran Konbini yang menunggu menjadi kedaluwarsa. Nilai yang valid adalah dari 1 hingga 60 hari. Lihat Kedaluwarsa.Tidak3

Kedaluwarsa

Pembayaran Konbini yang menunggu akan kedaluwarsa tepat sebelum tengah malam (23.59.59 WSJ) pada tanggal yang ditentukan. Misalnya, jika expires_after_days diatur ke 2 dan PaymentIntent dikonfirmasi pada hari Senin, pembayaran Konbini yang menunggu akan kedaluwarsa pada hari Rabu pukul 23.59.59 waktu Jepang (UTC +9).

Nomor telepon

Di formulir checkout Konbini, pelanggan Anda secara opsional dapat memberikan nomor telepon untuk digunakan sebagai nomor konfirmasi mereka. Hal ini menyederhanakan proses pembayaran mereka di minimarket ketika UI di-toko meminta pelanggan memberikan kode pembayaran dan nomor konfirmasi. Keduanya tercermin dalam instruksi pembayaran yang ditampilkan oleh Stripe setelah pelanggan menyerahkan formulir checkout. Jika pelanggan Anda tidak memberikan nomor telepon, Stripe akan menghasilkan nomor konfirmasi acak.

Stripe secara proaktif memblokir nomor telepon yang hanya terdiri dari nol.

Mengarahkan ulang ke halaman voucher yang di-hosting dari Stripe

Catatan

Tidak seperti pembayaran kartu, pelanggan tidak akan dialihkan ke success_url dengan pembayaran Konbini.

Setelah berhasil menyerahkan formulir Checkout, pelanggan akan diarahkan ulang ke hosted_voucher_url. Pelanggan dapat merujuk perintah pembayaran dari halaman yang di-hosting untuk mengetahui detail tentang cara memyelesaikan pembayaran mereka. Halaman ini dapat dilihat pada desktop dan seluler, serta dapat dicetak.

Stripe mengirim kejadian payment_intent.requires_action bila voucer Konbini berhasil dibuat. Jika Anda harus mengirim tautan voucer kepada pelanggan melalui email, Anda dapat menemukan hosted_voucher_url di payment_intent.next_action.konbini_display_details. Pelajari selengkapnya tentang cara memonitor PaymentIntent dengan webhook.

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

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

Penuhi pesanan Anda

Karena Konbini adalah metode pembayaran notifikasi yang tertunda, Anda harus menggunakan metode seperti webhook untuk memonitor status pembayaran dan menangani fulfillment pesanan. Pelajari selengkapnya tentang menyiapkan webhook dan memenuhi pesanan.

Kejadian berikut dikirim ketika status pembayaran berubah:

Nama KejadianKeteranganLangkah berikutnya

checkout.session.completed

Pelanggan telah berhasil menyerahkan formulir Checkout. Stripe telah membuat voucher Konbini.

Anda dapat memilih untuk mengirim hosted_voucher_url lewat email ke pelanggan Anda seandainya voucher Konbini mereka hilang.

Tunggu pelanggan membayar di Konbini.

checkout.session.async_payment_succeededPelanggan telah berhasil membayar voucher Konbini. PaymentIntent bertransisi ke succeeded.Penuhi barang atau layanan yang dibeli oleh pelanggan.
checkout.session.async_payment_failedVoucher Konbini telah kedaluwarsa, atau pembayaran gagal karena alasan lain. PaymentIntent kembali ke status requires_payment_method.Hubungi pelanggan melalui email dan minta agar mereka memesan lagi.

Mencoba integrasi Anda

Saat mencoba integrasi Checkout Anda, pilih Konbini sebagai metode pembayaran dan klik tombol Bayar.

Berikan nilai berikut di formulir Checkout untuk mencoba skenario berbeda. Anda dapat mencoba dengan nomor konfirmasi khusus atau pola email. Jika keduanya diberikan, maka yang berlaku adalah perilaku nomor konfirmasi khusus.

EmailNomor konfirmasiKeterangan

{any_prefix}@{any_domain}

11111111110

Menyimulasikan pembayaran Konbini yang berhasil setelah 3 menit dan webhook payment_intent.succeeded yang masuk setelah itu.

Contoh: hanako@test.com

{any_prefix}succeed_immediately@{any_domain}

22222222220

Menyimulasikan pembayaran Konbini yang seketika berhasil dan webhook payment_intent.succeeded yang masuk setelah itu.

Contoh: succeed_immediately@test.com

{any_prefix}expire_immediately@{any_domain}

33333333330

Menyimulasikan pembayaran Konbini yang segera kedaluwarsa dan webhook payment_intent.payment_failed yang masuk setelah itu.

Bidang expires_at di next_action.konbini_display_details diatur ke waktu saat ini, terlepas dari pengaturan parameter expires_after_days atau expires_at di opsi metode pembayaran.

Contoh: expire_immediately@test.com

{any_prefix}expire_with_delay@{any_domain}

44444444440

Menyimulasikan pembayaran Konbini yang tidak pernah berhasil; ini akan kedaluwarsa dalam waktu 3 menit dan webhook payment_intent.payment_failed akan masuk setelah itu.

Bidang expires_at di next_action.konbini_display_details diatur ke 3 menit mendatang terlepas dari pengaturan parameter expires_after_days atau expires_at di opsi metode pembayaran.

Contoh: expire_with_delay@test.com

{any_prefix}fill_never@{any_domain}

55555555550

Menyimulasikan pembayaran Konbini yang tidak pernah berhasil; Kedaluwarsa sesuai dengan bidang expires_at di next_action.konbini_display_details sesuai parameter yang diberikan di opsi metode pembayaran dan webhook payment_intent.payment_failed yang masuk setelah itu.

Contoh: fill_never@test.com

Untuk mencoba kesalahan nomor konfirmasi, Anda dapat menggunakan nilai-nilai berikut:

  • 01234567890 akan mensimulasikan penolakan nomor konfirmasi.
  • 00000000000 akan menghasilkan kesalahan validasi.

Kedaluwarsa dan pembatalan

Setelah waktu yang ditentukan oleh nilai expires_at di next_action.konbini_display_details, pelanggan tidak dapat lagi initiate proses pembayaran untuk pembayaran Konbini yang menunggu di kios minimarket. Namun, jika mengeluarkan slip pembayaran yang valid sebelum batas waktu, pelanggan mungkin dapat menyelesaikan pembayaran di kasir setelah waktu expires_at.

Ada periode penyangga untuk menghindari kegagalan pembayaran prematur dalam kejadian demikian. Status PaymentIntent berubah menjadi requires_payment_method. Pada titik ini, Anda dapat membatalkan atau mengonfirmasikan PaymentIntent dengan metode pembayaran lain.

Anda juga dapat membatalkan pembayaran Konbini yang menunggu setelah konfirmasi dan sebelum waktu yang ditentukan oleh next_action.konbini_display_details.expires_at. Memperbarui PaymentIntent atau mengonfirmasinya dengan metode pembayaran lain juga secara implisit akan membatalkan pembayaran Konbini yang ada.

Jika pelanggan saat ini melakukan pembayaran Konbini di minimarket, permintaan pembatalan akan gagal. Pembatalan dapat dicoba kembali jika pelanggan mengabaikan upaya pembayaran dan setelah slip pembayaran habis masa berlakunya.

Perhatikan bahwa masalah ketersedian metode pembayaran sementara juga memengaruhi permintaan pembatalan (baik eksplisit serta implisit).

Peringatan

Saat Anda membatalkan pembayaran yang menunggu, petunjuk pembayaran semula akan menjadi tidak valid. Bagi kebanyakan kasus penggunaan, kami menyarankan Anda untuk menghubungi pelanggan untuk menginformasikan tentang pembatalan ini.

Ketika Anda berhasil memastikan kembali PaymentIntent dalam status requires_action kami membuat petunjuk baru dan hosted_voucher_url baru. Anda harus memastikan bahwa pelanggan Anda mengetahui tentang hal ini.

Pengembalian dana

Pembayaran pengembalian dana Konbini dapat dilakukan melalui Dashboard atau API.

Untuk menyelesaikan pengembalian dana yang dikirim ke rekening bank pelanggan secara langsung, pelanggan Anda harus memberikan detail rekening bank untuk menerima dana tersebut. Stripe menghubungi pelanggan di alamat email dari detail tagihan pada metode pembayaran dan meminta detail ini dari mereka. Setelah menerima detail bank, kami akan memproses pengembalian dana secara otomatis.

Transisi status pengembalian dana sebagai berikut:

KejadianStatus pengembalian dana
Pengembalian dana dibuatrequires_action
Pelanggan menyerahkan detail rekening bank, dan Stripe mulai memproses pengembalian dananyapending
Pengembalian dana diperkirakan masuk di bank pelanggansucceeded
Bank pelanggan mengembalikan dana ke Striperequires_action
Pengembalian dana dalam requires_action 45 hari setelah pembuatanfailed
Pengembalian dana dibatalkan dari status requires_actioncanceled

Jika bank pelanggan tidak berhasil menyelesaikan transfer, dana dikembalikan ke Stripe dan transisi pengembalian dana ke requires_action. Hal ini dapat terjadi jika nama pemegang rekening tidak sesuai dengan yang tercatat di bank penerima atau jika nomor rekening bank yang diberikan salah ketik. Dalam kasus ini, Stripe mengirim email kepada pelanggan untuk memberitahukan kegagalan dan meminta mereka mengirimkan kembali detail rekening banknya.

Jika pelanggan Anda tidak memberikan detail rekening banknya dalam waktu 45 hari, status pengembalian dana bertransisi ke failed dan kami mengirim kejadian refund.failed. Ini berarti bahwa Stripe tidak dapat memproses pengembalian dana, dan Anda harus mengembalikan dana kepada pelanggan di luar Stripe.

Bidang instructions_email pada pengembalian dana merupakan email yang dikirimi pengembalian dana. Meski pengembalian dana menunggu tanggapan dari pelanggan, detail email yang dikirim kepada pelanggan juga dapat ditemukan di bawah bidang next_action.display_details.email_sent pada pengembalian dana.

Setiap pengembalian dana perorangan (termasuk setiap pengembalian dana sebagian) dapat dikenakan biaya. Hubungilah kontak Anda di Stripe untuk mempelajari selengkapnya tentang hal ini.

Mencoba Pengembalian Dana

Anda dapat mencoba perilaku pengembalian dana dalam mode percobaan menggunakan rekening bank percobaan berikut ini di halaman pengumpulan detail rekening bank yang ditautkan dalam email yang dikirim kepada pelanggan. Detail rekening bank di luar rekening bank percobaan ini tidak akan diterima.

RoutingAkunTipe
11000000001234Pengembalian dana berhasil.

1100000

1111113

1111116

1111113

3333335

4444440

Pengembalian dana gagal.

Mencoba Kedaluwarsa Pengembalian Dana

Anda dapat melakukan panggilan API untuk menyimulasikan berakhirnya pengembalian dana mode percobaan.

Command Line
curl https://api.stripe.com/v1/test_helpers/refunds/{{REFUND_ID}}/expire \
  -X POST \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:

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