Log perubahan Elements dengan Checkout Sessions APIPratinjau publik

Elements dengan Checkout Sessions API menggunakan dua jenis versi beta:

• Header beta Stripe.js (mis., custom_checkout_beta_5), yang diatur pada integrasi frontend Anda.
• Header beta versi API (mis., custom_checkout_beta=v1), yang diatur pada integrasi backend Anda.

Versi beta frontend

Tentukan versi beta frontend ketika menginisialisasi Stripe.js.

custom_checkout_beta_5

• Breaking Fungsi initCustomCheckout telah diganti namanya menjadi initCheckout
  • Dalam React Stripe.js, CustomCheckoutProvider telah diubah namanya menjadi CheckoutProvider dan useCustomCheckout telah diubah namanya menjadi useCheckout.
• Breaking Untuk mengonfirmasikan Express Checkout Element, panggil confirm, sehingga meneruskan confirm event sebagai expressCheckoutConfirmEvent
  • Sebelumnya, Express Checkout Element dikonfirmasikan dengan memanggil event.confirm().
• Breaking Bila confirm dipanggil, Payment Element dan Address Element akan memvalidasi input formulir serta menampilkan kesalahan.
• Breaking Pesan kesalahan telah distandardisasi dan ditingkatkan.
  • Kesalahan yang dikembalikan/diselesaikan oleh fungsi mewakili skenario yang diketahui seperti detail pembayaran yang tidak valid atau dana yang tidak mencukupi. Ini adalah masalah yang dapat diprediksi dan dapat dikomunikasikan kepada pelanggan Anda dengan menampilkan message pada halaman checkout.
  • Kesalahan yang dilemparkan/ditolak oleh fungsi mewakili kesalahan dalam integrasi itu sendiri, seperti parameter atau konfigurasi yang tidak valid. Kesalahan ini tidak dimaksudkan untuk ditampilkan kepada pelanggan Anda.
• Breaking Metode asinkron, seperti confirm atau applyPromotionCode, diselesaikan dengan skema yang berbeda:
  • Bidang diskriminator type="success"|"error" telah ditambahkan.
  • Jika berhasil, status sesi yang diperbarui diisi di bawah kunci success. Sebelumnya, ini berada di bawah kunci session.
  • Jika tidak, kesalahan akan terus diisi di bawah kunci error.
• Menambahkan opsi email, phoneNumber, billingAddress, dan shippingAddress ke confirm.
• Breaking Address Element tidak lagi secara otomatis memperbarui bidang billingAddress atau shippingAddress pada Sesi.
  • Selama Address Element dipasang, nilai formulir akan secara otomatis digunakan ketika memanggil confirm.
  • Dengarkan kejadian perubahan untuk menggunakan nilai Address Element sebelum konfirmasi.

custom_checkout_beta_4

• Menambahkan gambar ke objek Sesi.
• Menambahkan bidang sebagai opsi ketika membuat Payment Element.
• Menambahkan paymentMethods sebagai opsi ketika membuat Express Checkout Element.
• Breaking Meneruskan opsi yang tidak valid ke createElement sekarang memunculkan kesalahan. Sebelumnya, opsi yang tidak dikenal akan diabaikan secara diam-diam.
• Breaking updateEmail dan updatePhoneNumber menerapkan perubahan secara asinkron. Memanggil metode ini sebelum pelanggan selesai memasukkan nilai lengkap dapat menyebabkan kinerja yang buruk.
  • Sebagai ganti menelepon updateEmail atau updatePhoneNumber pada setiap kejadian perubahan input, tunggu sampai pelanggan Anda menyelesaikan input, seperti pada input yang mengabur atau saat mereka menyerahkan formulir untuk pembayaran.
  • updateEmail sekarang memvalidasi bahwa input adalah alamat email yang dibentuk dengan benar dan mengembalikan kesalahan jika input yang tidak valid digunakan.
  • updatePhoneNumber masih tidak melakukan validasi pada string input.

custom_checkout_beta_3

• Bidang berikut telah ditambahkan ke objek Sesi:
  • id
  • livemode
  • businessName
• Kartu yang disimpan sekarang dapat digunakan kembali. Pelajari cara menyimpan dan menggunakan kembali metode pembayaran.
• Breaking Default tata letak dari Payment Element telah diubah ke accordion.
  • Untuk terus menggunakan tata letak default sebelumnya, Anda harus menentukan layout='tabs'.
• Breaking Perilaku default confirm telah diubah untuk selalu dialihkan ke return_url Anda setelah konfirmasi berhasil.
  • Sebelumnya, confirm dialihkan hanya jika pelanggan memilih metode pembayaran berbasis pengalihan. Untuk terus menggunakan perilaku lama, Anda harus meneruskan pengalihan=‘if_required’ ke confirm.

custom_checkout_beta_2

• Breaking Bidang lineItem.recurring.interval_count ini telah dihapus dan diganti dengan lineItem.recurring.intervalCount.
• Breaking Bidang lineItem.amount ini telah dihapus dan diganti dengan yang berikut ini:
  • lineItem.amountSubtotal
  • lineItem.amountDiscount
  • lineItem.amountTaxInclusive
  • lineItem.amountTaxExclusive

custom_checkout_beta_1

Ini adalah versi beta front-end awal.

Log perubahan backend

Tentukan versi beta backend ketika menyiapkan pustaka server Anda.

Tidak ada perubahan pada versi beta backend.