Elements con el registro de cambios de la API Checkout SessionsVista previa pública

Realiza un seguimiento de los cambios en Elements con la integración de la API Checkout Sessions.

Elements con la API Checkout Sessions utiliza dos tipos de versiones beta:

Un encabezado beta Stripe.js (por ejemplo, custom_checkout_beta_5), que se establece en tu integración de front-end.
Un encabezado beta de la versión de la API (por ejemplo, custom_checkout_beta=v1), que se establece en tu integración de back-end.

Versiones beta del front-end

Especifica la versión beta del front-end al inicializar Stripe.js.

custom_checkout_beta_5

Breaking Se renombró la función initCustomCheckout como initCheckout
- Dentro de React Stripe. js, se renombró al CustomCheckoutProvider como CheckoutProvider y a useCustomCheckout como useCheckout.
Breaking Para confirmar el Express Checkout Element, llama a confirm, pasando el evento de confirmación como expressCheckoutConfirmEvent
- Anteriormente, Express Checkout Element se confirmaba llamando a event.confirm().
Breaking Cuando se llama a confirm, el Payment Element y Address Element validarán las entradas del formulario y representarán cualquier error.
Breaking Los mensajes de error se han estandarizado y mejorado.
- Los errores devueltos/resueltos por una función representan escenarios conocidos, como datos de pago no válidos o fondos insuficientes. Se trata de problemas predecibles que se pueden comunicar a tu cliente mostrando el message en la página de pago.
- Los errores arrojados/rechazados por una función representan errores en la propia integración, como parámetros o configuración no válidos. Estos errores no están pensados para mostrarse a tus clientes.
Breaking Los métodos asincrónicos, como confirm o applyPromotionCode, se resuelven con un esquema diferente:
- Se agregó un campo discriminador type="success"|"error".
- Si se realiza correctamente, el estado de sesión actualizado se completa automáticamente en la clave success. Anteriormente, esto se encontraba en la clave session.
- De lo contrario, el error se sigue completando automáticamente en la clave error.
Se agregaron las opciones email, phoneNumber, billingAddress y shippingAddress a confirm.
Breaking Address Element ya no actualiza automáticamente los campos billingAddress o shippingAddress en la sesión.
- Siempre que Address Element esté montado, los valores del formulario se usarán automáticamente al llamar a confirm.
- Escucha el evento de cambio para usar el valor del Address Element antes de la confirmación.

custom_checkout_beta_4

Se agregaron imágenes al objeto Session.
Se agregaron campos como una opción al crear el Payment Element.
Se agregaron paymentMethods como una opción al crear Express Checkout Element.
Breaking Al pasar opciones no válidas a createElement, se produce un error. Anteriormente, las opciones no reconocidas se ignoraban silenciosamente.
Breaking updateEmail y updatePhoneNumber aplican los cambios de forma asincrónica. Llamar a estos métodos antes de que el cliente termine de escribir los valores completos puede provocar un rendimiento deficiente.
- En lugar de llamar a updateEmail o updatePhoneNumber en el evento de cambio de cada entrada, espera hasta que tu cliente termine la entrada, por ejemplo, en el desenfoque de entrada o cuando envía el formulario para el pago.
- updateEmail ahora valida que la entrada sea una dirección de correo electrónico con el formato correcto y devuelve un error si se utiliza una entrada no válida.
- updatePhoneNumber sigue sin realizar ninguna validación en la cadena de entrada.

custom_checkout_beta_3

Se han agregado los siguientes campos al objeto Session:
Las tarjetas guardadas ahora se pueden reutilizar. Aprende a guardar y reutilizar los métodos de pago.
Breaking El diseño predeterminado del Payment Element ha cambiado a accordion.
- Para seguir utilizando el diseño predeterminado anterior, debes especificar layout='tabs' explícitamente.
Breaking El comportamiento predeterminado de confirm se ha cambiado para redirigir siempre a tu return_url después de una confirmación correcta.
- Antes, confirm realizaba un redireccionamiento solo si el cliente elegía un método de pago basado en el redireccionamiento. Para continuar usando el comportamiento anterior, debes pasar redirect’=if_required’ a confirm.

custom_checkout_beta_2

Breaking El campo lineItem.recurring.interval_count se ha eliminado y reemplazado por lineItem.recurring.intervalCount.
Breaking El campo lineItem.amount se ha eliminado y reemplazado por lo siguiente:

custom_checkout_beta_1

Esta es la versión beta inicial del front-end.

Registro de cambios de back-end

Especifica la versión beta del back-end al configurar la biblioteca del servidor.

No hay cambios en la versión beta del back-end.