Migrasikan integrasi kartu dasar Anda

Buat dua perubahan pada endpoint di server Anda yang membuat PaymentIntent:

1. Hapus parameter error_on_requires_action agar pembayaran yang memerlukan autentikasi tidak lagi gagal. Sebagai gantinya, status PaymentIntent berubah menjadi requires_action.
2. Tambahkan parameter confirmation_method untuk menunjukkan bahwa Anda ingin secara eksplisit (manual) mengonfirmasi pembayaran lagi di server setelah menangani permintaan autentikasi.

curl https://api.stripe.com/v1/payment_intents \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d amount=1099 \
  -d currency=usd \
  -d payment_method_types[]=card \
  -d confirm=true \
  -d error_on_requires_action=true \
  -d payment_method="{{PAYMENT_METHOD_ID}}" \
  -d confirmation_method=manual

Kemudian perbarui fungsi “hasilkan respons” Anda untuk menangani status requires_action sebagai ganti memunculkan kesalahan:

# If the request succeeds, check the
# PaymentIntent's `status` and handle
# its `next_action`.

Selanjutnya, perbarui kode sisi klien Anda untuk memberi tahu Stripe agar menampilkan modal jika pelanggan perlu mengautentikasi.

Gunakan stripe.handleCardAction bila PaymentIntent berstatus requires_action. Jika berhasil, PaymentIntent akan berstatus requires_confirmation dan Anda perlu mengonfirmasi PaymentIntent lagi pada server untuk menyelesaikan pembayaran.

const handleServerResponse = async (responseJson) => {
  if (responseJson.error) {
    // Show error from server on payment form
  } else if (responseJson.requiresAction) {
    // Use Stripe.js to handle the required card action
    const { error: errorAction, paymentIntent } =
      await stripe.handleCardAction(responseJson.clientSecret);

    if (errorAction) {
      // Show error from Stripe.js in payment form
    } else {
      // The card action has been handled
      // The PaymentIntent can be confirmed again on the server
      const serverResponse = await fetch('/pay', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ payment_intent_id: paymentIntent.id })
      });
      handleServerResponse(await serverResponse.json());
    }
  } else {
    // Show success message
  }
}

Dengan menggunakan endpoint sama yang Anda siapkan sebelumnya, konfirmasikan PaymentIntent lagi untuk memfinalisasi pembayaran dan memenuhi pesanan. Upaya pembayaran gagal dan berubah kembali menjadi requires_payment_method jika tidak dikonfirmasi lagi dalam waktu satu jam.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/confirm \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -X "POST"

Gunakan kartu percobaan kami di sandbox untuk memverifikasikan bahwa integrasi Anda telah diperbarui dengan benar. Stripe menampilkan halaman autentikasi palsu di dalam modal di sandbox yang memungkinkan Anda menyimulasikan upaya autentikasi yang berhasil atau gagal. Dalam mode live, bank mengontrol UI dari apa yang ditampilkan di dalam modal.