Saltar al contenido principal
Disponible desde Yuno iOS SDK 2.24.0 y Yuno Web SDK 1.10.8. El desglose del pedido, las actualizaciones de la dirección de envío y un selector de método de envío convierten la hoja de Apple Pay en un express checkout:
  • 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.
Cada capacidad es opcional. Si no las usas, tu integración de Apple Pay funciona exactamente como antes.

Requisitos

Cómo funciona

  1. Tu backend agrega summary_items y/o shipping_methods cuando crea la sesión de checkout.
  2. Tu aplicación registra onShippingAddressChanged: en iOS, en el delegate que ya pasa al flujo de pago; en Web, en externalButtons cuando inicia el checkout.
  3. 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.
  4. Después de que el cliente autoriza, el token de un solo uso incluye un objeto shipping con el método seleccionado y la dirección completa.
Dos reglas aplican en todos los casos:
  • Toda lista summary_items debe terminar con el total general. Su amount es el total que se muestra en la hoja, y su label se 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)

Agrega summary_items cuando crees la sesión de checkout:
La hoja ahora muestra el desglose con el total etiquetado como “ACME Inc.”. No se necesita código en la aplicación.
  • 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_items y sin shipping_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

Agrega shipping_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.
  • label es el nombre de la opción y detail su 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_items de ese método. Un método sin desglose conserva los totales que ya están en la hoja.
  • delivery_estimate es un par from y to de fechas YYYY-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

Registra onShippingAddressChanged 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á.
Haz que el delegate que ya pasas al flujo de pago cumpla con 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.
Si no usas async, o integras desde Objective-C, implementa en su lugar la variante basada en completion que YunoPaymentDelegate declara como opcional:
Implementa una de las dos. Cuando existen ambas, el SDK llama a la 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, o nil (null en Web) para dejar la hoja como está.

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 en yunoCreatePayment incluye un objeto shipping con el método seleccionado y la dirección completa:
  • method es el seleccionado en la hoja, o el primero si el cliente no lo cambió.
  • Los summary_items no 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.
Usa este objeto en tu servidor para cobrar el monto final, validar la dirección y enviar el pedido.

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