Elements con log delle modifiche per l'API Checkout SessionsAnteprima pubblica

Tieni traccia delle modifiche a Elements con l'integrazione dell'API Checkout Sessions.

Elements con l’API Checkout Sessions utilizza due tipi di versioni beta:

Un’intestazione beta Stripe.js (ad es. custom_checkout_beta_5), impostata nella tua integrazione del front-end.
Un’intestazione beta della versione dell’API (ad es. custom_checkout_beta=v1), impostata nella tua integrazione del back-end.

Versioni beta del front-end

Specifica la versione beta del front-end durante l’inizializzazione di Stripe.js.

custom_checkout_beta_5

Breaking La funzione initCustomCheckout è stata rinominata initCheckout
- In di React Stripe.js, CustomCheckoutProvider è stato rinominato CheckoutProvider e useCustomCheckout è stato rinominato useCheckout.
Breaking Per confermare Express Checkout Element, chiama confirm, specificando l’evento confirm come expressCheckoutConfirmEvent
- In precedenza, Express Checkout Element veniva confermato chiamando event.confirm().
Breaking Quando viene chiamato confirm, Payment Element e Address Element convalidano gli input del modulo e visualizzano eventuali errori.
Breaking I messaggi di errore sono stati standardizzati e migliorati.
- Gli errori restituiti/risolti da una funzione rappresentano scenari noti, come dati di pagamento non validi o fondi insufficienti. Si tratta di problemi prevedibili che possono essere comunicati al cliente visualizzando message nella pagina di pagamento.
- Gli errori generati/rifiutati da una funzione rappresentano errori nell’integrazione stessa, ad esempio parametri o configurazione non validi. Questi errori non devono essere mostrati ai clienti.
Breaking I metodi asincroni, ad esempio confirm o applyPromotionCode, vengono risolti con uno schema diverso:
- È stato aggiunto un campo discriminatore type="success"|"error".
- In caso di esito positivo, lo stato aggiornato della sessione viene popolato nella chiave success. In precedenza, questa informazione era nella chiave session.
- In caso contrario, l’errore continua a essere popolato nella chiave error.
Aggiunta delle opzioni email, phoneNumber, billingAddress e shippingAddress per confirm.
Breaking Address Element non aggiorna più automaticamente i campi billingAddress o shippingAddress nell’oggetto Session.
- Finché Address Element è montato, i valori del modulo verranno utilizzati automaticamente durante la chiamata di confirm.
- Ascolta l’evento change per utilizzare il valore di Address Element prima della conferma.

custom_checkout_beta_4

Aggiunta di immagini all’oggetto Session.
Aggiunta dei i campi come opzione durante la creazione del Payment Element.
Aggiunta di paymentMethods come opzione durante la creazione di Express Checkout Element.
Breaking Se specifichi opzioni non valide per createElement, viene generato un errore. In precedenza, le opzioni non riconosciute venivano ignorate automaticamente.
Breaking updateEmail e updatePhoneNumber applicano le modifiche in modo asincrono. La chiamata a questi metodi prima che il cliente finisca di inserire i valori completi potrebbe compromettere le prestazioni.
- Invece di chiamare updateEmail o updatePhoneNumber nell’evento di modifica di ogni input, attendi che il cliente completi l’inserimento, ad esempio quando l’utente fa clic al di fuori del campo di inserimento o quando invia il modulo per il pagamento.
- updateEmail verifica che l’input sia un indirizzo email formato correttamente e restituisce un errore se viene utilizzato un input non valido.
- updatePhoneNumber non esegue ancora alcuna convalida sulla stringa di input.

custom_checkout_beta_3

I seguenti campi sono stati aggiunti all’oggetto Session:
Le carte salvate ora possono essere riutilizzate. Scopri come salvare e riutilizzare i metodi di pagamento.
Breaking Il layout predefinito di Payment Element è stato sostituito da accordion.
- Per continuare a utilizzare il layout predefinito precedente, devi specificare in modo esplicito layout='tabs'.
Breaking Il comportamento predefinito di confirm è stato modificato in modo da reindirizzare sempre al tuo return_url dopo una conferma riuscita.
- In precedenza, confirm reindirizzava solo se il cliente sceglieva un metodo di pagamento con reindirizzamento. Per continuare a utilizzare il comportamento precedente, devi specificare redirect=‘if_required’ in confirm.

custom_checkout_beta_2

Breaking Il campo lineItem.recurring.interval_count è stato rimosso e sostituito con lineItem.recurring.intervalCount.
Breaking Il campo lineItem.amount è stato rimosso e sostituito con il seguente:

custom_checkout_beta_1

Questa è la versione beta iniziale del front-end.

Log delle modifiche del back-end

Specifica la versione beta del back-end durante la configurazione della libreria del server.

Non sono presenti modifiche alla versione beta del back-end.