- Desglose del pedido: muestra subtotal, envío, impuestos y descuentos en lugar de un solo total.
- Actualizaciones de la dirección de envío: recalcula el pedido cuando el cliente elige o cambia su dirección de envío, sin salir de la hoja.
- Selector de método de envío: permite que el cliente elija Estándar, Express o Mismo día en la hoja, con actualización instantánea de precios.
Requisitos
Cómo funciona
- Tu backend agrega
summary_itemsy/oshipping_methodscuando crea la sesión de checkout. - Tu aplicación registra
onShippingAddressChanged: en iOS, en el delegate que ya pasa al flujo de pago; en Web, enexternalButtonscuando inicia el checkout. - En la hoja de Apple Pay, cambiar el método de envío actualiza el precio al instante sin llamar a tu aplicación. Elegir o cambiar la dirección de envío llama a tu handler, para que puedas devolver nuevos totales, nuevos métodos o un error.
- Después de que el cliente autoriza, el token de un solo uso incluye un objeto
shippingcon el método seleccionado y la dirección completa.
- Toda lista
summary_itemsdebe terminar con el total general. Suamountes el total que se muestra en la hoja, y sulabelse muestra junto a él como la línea del beneficiario (recomendamos el nombre de tu tienda). - Todos los montos deben usar la moneda de la sesión. Una moneda diferente hace que el SDK ignore ese desglose o respuesta.
Paso 1: muestra un desglose del pedido (solo backend)
Agregasummary_items cuando crees la sesión de checkout:
- La última entrada se muestra como el total general y su etiqueta como la línea del beneficiario.
- Los descuentos pueden ser negativos, por ejemplo
-5.00. - Cuando también envías
shipping_methods(Paso 2), la hoja se abre con el desglose del primer método y esta lista se ignora. - Sin
summary_itemsy sinshipping_methods, la hoja muestra una sola línea con el monto de la sesión.
Paso 2: ofrece métodos de envío en la hoja
Agregashipping_methods a la sesión de checkout. Cada método tiene sus propios summary_items, de modo que la hoja puede actualizar el precio en cuanto el cliente cambia de método:
- El primer método viene preseleccionado y su desglose es con el que se abre la hoja.
labeles el nombre de la opción ydetailsu descripción. Apple Pay muestra el precio junto a la opción.- Cambiar de método nunca llama a tu aplicación ni a tu backend. El total proviene de los
summary_itemsde ese método. Un método sin desglose conserva los totales que ya están en la hoja. delivery_estimatees un parfromytode fechasYYYY-MM-DD. Se muestra como un rango de fechas junto a la opción en iOS 15 y posteriores, y en Web en los navegadores que admiten Apple Pay JS versión 12 (Safari 15 y posteriores). Un rango invertido o mal formado no se muestra.- La hoja acepta hasta 100 métodos, 100 summary items y 100 ítems por método. Por encima de eso, el SDK de iOS abre la hoja sin métodos de envío, y el SDK Web no abre la hoja y reporta un error.
Paso 3: reacciona a los cambios de dirección de envío
RegistraonShippingAddressChanged cuando inicies el flujo. Tu handler recibe la dirección censurada y responde con nuevos totales, nuevos métodos, un error o nada para dejar la hoja como está.
- iOS
- Web
Haz que el delegate que ya pasas al flujo de pago cumpla con Si no usas Implementa una de las dos. Cuando existen ambas, el SDK llama a la
YunoShippingDelegate e implementa onShippingAddressChanged. Funciona con todos los flujos que reciben un YunoPaymentDelegate: startCheckout, startPaymentLite y la lista de métodos de pago del modo Full.async, o integras desde Objective-C, implementa en su lugar la variante basada en completion que YunoPaymentDelegate declara como opcional:async.Lo que recibes: ShippingInfo
Antes de la autorización, Apple Pay comparte solo una parte de la dirección, que es suficiente para cotizar el envío y los impuestos:
Cualquier campo puede faltar:
nil en iOS, ausente en Web. La dirección completa llega en el token de un solo uso (Paso 4).
Lo que devuelves: ShippingUpdate
Devuelve cualquier combinación de estos, onil (null en Web) para dejar la hoja como está.
- iOS
- Web
Reglas
A diferencia de Google Pay, un error en la hoja de Apple Pay sí bloquea el pago: el cliente tiene que elegir otra dirección antes de pagar. Aun así, valida la dirección en tu servidor cuando crees el pago.
Paso 4: lee el resultado en el token de un solo uso
Después de que el cliente autoriza, el token de un solo uso que recibes enyunoCreatePayment incluye un objeto shipping con el método seleccionado y la dirección completa:
methodes el seleccionado en la hoja, o el primero si el cliente no lo cambió.- Los
summary_itemsno se envían de vuelta. - El objeto se incluye siempre que la hoja haya recopilado un método de envío o una dirección, con o sin handler. Los pagos sin ninguno de los dos no incluyen
shipping.
Qué sucede en cada caso
Es bueno saber
- En iOS, Apple Pay no es compatible con el iOS Simulator. Prueba en un dispositivo físico. En Web, prueba en Safari en un dispositivo con Apple Pay configurado.
- Apple Pay censura la dirección hasta que se autoriza el pago, por lo que tu handler nunca ve las líneas de calle.
- El método seleccionado sigue seleccionado cuando el cliente cambia la dirección, a menos que devuelvas nuevos métodos.
- Privacidad: el SDK nunca registra direcciones, emails ni datos de pago.
Solución de problemas
Documentación relacionada
- Configuración y pagos de un solo uso
- Express checkout de Google Pay en Android
- Fast Checkout Shipping. Los mismos campos de sesión y el nodo
shippingen billeteras que eligen la dirección dentro del widget. - Changelog del SDK de iOS y Changelog del SDK Web