Pembayaran Konbini

Pertama, Anda membutuhkan akun Stripe. Daftar sekarang.

Gunakan pustaka resmi kami untuk mendapatkan akses ke API Stripe dari aplikasi Anda:

# Available as a gem
sudo gem install stripe

# If you use bundler, you can add this line to your Gemfile
gem 'stripe'

Stripe menggunakan objek PaymentIntent untuk mewakili maksud Anda menagih pembayaran dari pelanggan, melacak perubahan status dari pembuatan PaymentIntent Konbini hingga selesai.

Buat PaymentIntent di server Anda dengan jumlah dan mata uang jpy (Konbini tidak mendukung mata uang lain). Jika Anda sudah memiliki integrasi menggunakan Payment Intents API, tambahkan konbini ke daftar tipe metode pembayaran untuk PaymentIntent Anda.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1099 \
  -d currency=jpy \
  -d "payment_method_types[]"=konbini \
  -d "payment_method_options[konbini][product_description]"="Tシャツ" \
  -d "payment_method_options[konbini][expires_after_days]"=3

Ambil client secret

PaymentIntent menyertakan client secret yang digunakan pada sisi client untuk menyelesaian proses pembayaran dengan aman. Anda dapat menggunakan pendekatan berbeda untuk meneruskan client secret ke sisi client.

get '/secret' do
  intent = # ... Create or retrieve the PaymentIntent
  {client_secret: intent.client_secret}.to_json
end

(async () => {
  const response = await fetch('/secret');
  const {client_secret: clientSecret} = await response.json();
  // Render the form using the clientSecret
})();

Opsi metode pembayaran tambahan

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

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).

Pengaturan expires_at adalah cap waktu Unix dalam detik. Jika nilainya kurang dari 30 menit dari waktu saat ini, atau konfirmasi PaymentIntent terjadi kurang dari 30 menit sejak waktu kedaluwarsa, maka kesalahan akan dikembalikan.

expires_after_days dan expires_at saling terpisah. Kesalahan akan dikembalikan jika keduanya diatur. Keduanya juga opsional, dan jika tidak ada yang diatur, maka tanggal kedaluwarsa default menjadi 3 hari setelah pembuatan PaymentIntent pada pukul 23.59 waktu Jepang (UTC +9).

Penanganan kesalahan

Permintaan pada PaymentIntent seperti pembuatan, pembaruan, dan konfirmasi dapat gagal. Anda dapat memeriksa nilai error dari respons API untuk menentukan alasannya dan dalam banyak situasi baik menyerahkan ulang permintaan atau memperbaiki kesalahan tersebut. Jika Anda memberikan nilai opsi metode pembayaran confirmation_number, maka Anda mungkin ingin menangani kode kesalahan spesifik yang kami kembalikan. Lihat Nomor konfirmasi untuk detail selengkapnya.

Metode pembayaran untuk sementara mungkin sesekali tidak tersedia karena listrik mati, pemeliharaan terjadwal, atau pola penggunaan Anda. Lihat Menangani masalah ketersediaan sementara untuk detail selengkapnya.

Buat formulir pembayaran pada client Anda untuk mengumpulkan detail tagihan yang diperlukan dari pelanggan:

Contoh formulir di sini juga mengumpulkan nomor telepon, untuk digunakan sebagai nomor konfirmasi yang disediakan oleh pelanggan:

<form id="payment-form">
  <div class="form-row">
    <label for="name">
      Name
    </label>
    <input id="name" name="name" required>
  </div>

  <div class="form-row">
    <label for="email">
      Email
    </label>
    <input id="email" name="email" required>
  </div>

  <div class="form-row">
    <label for="phone">
      Phone Number
    </label>
    <input id="phone" name="phone" required>
  </div>

  <!-- Used to display form errors. -->
  <div id="error-message" role="alert"></div>

  <button id="submit-button">Pay with Konbini</button>
</form>

Saat pelanggan mengklik untuk membayar dengan Konbini, gunakan Stripe.js untuk menyerahkan pembayaran kepada Stripe. Stripe.js adalah pustaka JavaScript kami yang mendasar untuk membangun alur pembayaran.

Sertakan skrip Stripe.js di halaman checkout dengan menambahkannya ke head file HTML Anda.

<head>
  <title>Checkout</title>
  <script src="https://js.stripe.com/basil/stripe.js"></script>
</head>

Buat instance Stripe.js dengan JavaScript berikut di halaman checkout Anda.

// Set your publishable key. Remember to switch to your live publishable key in production!
// See your keys here: https://dashboard.stripe.com/apikeys
const stripe = Stripe(
'pk_test_TYooMQauvdEDq54NiTphI7jx');

Gunakan stripe.confirmKonbiniPayment dan client secret objek PaymentIntent yang Anda buat di Langkah 2 untuk menyerahkan detail tagihan pelanggan.

Setelah konfirmasi, Stripe akan secara otomatis membuka modal untuk menampilkan instruksi pembayaran Konbini kepada pelanggan Anda.

const form = document.getElementById('payment-form');

form.addEventListener('submit', async (event) => {
  event.preventDefault();

  const result = await stripe.confirmKonbiniPayment(
    '{{PAYMENT_INTENT_CLIENT_SECRET}}',
    {
      payment_method: {
        billing_details: {
          name: document.getElementById('name').value,
          email: document.getElementById('email').value,
        },
      },
      payment_method_options: {
        konbini: {
          confirmation_number: document.getElementById('phone').value.replace(/\D/g,''),
        },
      },
    }
  );
  // Stripe.js will open a modal to display the Konbini payment instructions to your customer
  // This async function finishes when the customer closes the modal

  if (result.error) {
    // Display error to your customer
    const errorMsg = document.getElementById('error-message');
    errorMsg.innerText = result.error.message;
  }
});

Opsi metode pembayaran tambahan

Ketika mengonfirmasi PaymentIntent Konbini, Anda dapat menentukan opsi metode pembayaran tambahan di opsi metode pembayaran, pada kunci konbini.

Nomor konfirmasi

Pelanggan Anda perlu menyebutkan confirmation_number saat menyelesaikan pembayaran. Saran umum untuk nilai ini, jika Anda memilih untuk mengaturnya atau mengizinkan pelanggan mengaturnya, adalah nomor telepon pelanggan. Suatu confirmation_number juga dapat diatur selama pembuatan PaymentIntent sisi server, tetapi yang lebih umum diatur sisi client oleh pelanggan selama konfirmasi PaymentIntent. Ini dapat diperbarui dari nilai yang diatur selama pembuatan PaymentIntent hingga konfirmasi.

Jika confirmation_number yang ditentukan terlalu umum di antara transaksi minimarket yang sedang berlangsung, maka mungkin akan ditolak saat konfirmasi PaymentIntent. Kode kesalahan yang dikembalikan dalam hal ini adalah payment_intent_konbini_rejected_confirmation_number, yang hanya diperkirakan saat mengonfirmasikan PaymentIntent.

Stripe secara proaktif memblokir nomor konfirmasi yang terdiri dari hanya nol pada saat pembuatan PaymentIntent serta selama pembaruan dan konfirmasi. Pastikan di pihak Anda tidak mengatur nilai ini atau mengizinkan pelanggan mengaturnya.

Penanganan kesalahan

Mengonfirmasi sisi client PaymentIntent juga mungkin gagal. Anda harus memeriksa nilai pengembalian error untuk menentukan sebabnya dan dapat menampilkan kesalahan tersebut kepada pelanggan atau perbaiki kesalahan tersebut dan coba lagi.

Konbini adalah metode pembayaran notifikasi tertunda, sehingga dana tidak segera tersedia. Pelanggan mungkin tidak membayar pembayaran Konbini yang menunggu di minimarket begitu selesai checkout.

Setelah Pembayaran Konbini yang menunggu selesai, Stripe mengirim kejadian payment_intent.succeeded untuknya. Gunakan Dashboard atau buat handler webhook untuk menerima kejadian ini dan menjalankan tindakan. Contoh tindakan termasuk mengirim email konfirmasi pesanan kepada pelanggan Anda, mencatat penjualan di database, atau memulai alur kerja pengiriman.

Bila jelas bahwa pembayaran Konbini yang menunggu tidak selesai, biasanya sekitar satu jam setelah batas waktu kedaluwarsa, Stripe akan mengirim kejadian payment_intent.payment_failed.

Terima kejadian dan jalankan tindakan bisnis

Secara manual

Gunakan Dashboard Stripe untuk melihat semua pembayaran Stripe Anda, mengirim resi email, menangani payout, atau mencoba ulang pembayaran yang gagal.

• Lihat pembayaran percobaan Anda di Dashboard

Kode Custom

Bangun handler webhook untuk mendengarkan kejadian dan bangun alur pembayaran asinkron custom. Coba dan debug integrasi webhook Anda secara lokal dengan Stripe CLI.

• Bangun webhook custom

Ketika mencoba, atur payment_method.billing_details.email ke nilai berikut bila Anda memanggil stripe.confirmKonbiniPayment untuk mencoba berbagai skenario. Anda dapat mencoba dengan nomor konfirmasi khusus ataupun pola email. Jika keduanya diberikan, maka yang berlaku adalah perilaku nomor konfirmasi khusus.

Untuk mencoba penanganan kesalahan nomor konfirmasi, Anda dapat menggunakan nilai-nilai berikut untuk payment_method_options[confirmation_number]:

• 01234567890 menghasilkan kode kesalahan payment_intent_konbini_rejected_confirmation_number.
• 00000000000 menghasilkan kode kesalahan validasi generik. Anda harus menghindari kesalahan ini dalam integrasi menggunakan pravalidasi.