Configuración requeridaAntes de implementar pagos con Apple Pay, asegúrate de haber completado los requisitos previos.
Entorno de pruebasApple Pay no es compatible con el simulador de iOS. Para probar la funcionalidad de Apple Pay, debes usar un dispositivo iOS físico.
Apple Pay en la web no se limita a Safari ni a dispositivos Apple. También funciona en navegadores de terceros en iPhone, iPad y macOS, y en cualquier navegador en Windows mediante el flujo de pago entre dispositivos de Apple. Consulta Dispositivos y navegadores compatibles para ver la matriz completa.
Incrustación de iframe de origen cruzado (Web SDK 1.11.31+)Cuando incrustas el checkout en un iframe alojado en un dominio distinto, Safari exige validar la sesión de comercio de Apple Pay contra el dominio de la página principal de nivel superior. El Web SDK lo detecta automáticamente. El dominio de nivel superior debe estar registrado en la conexión de Apple Pay; de lo contrario, la sesión recurre al dominio del iframe. Puedes especificar explícitamente el dominio principal o desactivar la detección con
externalButtons.applePay.topLevelDomain. Consulta la referencia del Web SDK.Descripción general de Apple Pay
- El cliente inicia el pago en su dispositivo iOS
- Recibe el
payment_tokenmediante el SDK de Apple - Crea una sesión de checkout con Yuno
- Yuno procesa con tus proveedores configurados y devuelve una respuesta
- Monitorea el estado de la respuesta mediante webhooks
Agregar la capacidad de Apple Pay
Para agregar la capacidad de Apple Pay a tu app de iOS:- En Xcode, selecciona tu proyecto en el navegador
- Selecciona el target de tu app
- Ve a la pestaña Signing & Capabilities
- Haz clic en + Capability y busca “Apple Pay”
- Agrega la capacidad Apple Pay
- Configura tus Merchant IDs en la sección de Apple Pay
Pagos de un solo uso con el SDK
Crear la sesión de checkout
Usa el endpoint crear sesión de checkout para crear una sesión de pago para transacciones de Apple Pay de un solo uso:Personalizar la hoja de pago (summary_items)
Para mostrar un desglose detallado de precios o controlar lo que aparece en la hoja de pago de Apple Pay, incluye un arreglo summary_items de nivel superior al crear la sesión de checkout:
summary_items a la hoja de pago de Apple Pay:
- Los elementos anteriores aparecen como líneas individuales.
- El último elemento representa el total general.
- Apple Pay muestra la etiqueta del total justo después de “Pay” en la hoja (por ejemplo, “Pay Your Business Name”). Define esta etiqueta con el nombre de tu negocio o comercio en lugar de “Total”, para que la hoja identifique claramente tu negocio ante el cliente.
summary_items debe coincidir con la moneda de la sesión. Si también ofreces selección de entrega dentro de la wallet, consulta Fast Checkout Shipping para configurar summary_items por método de entrega.
Procesar el pago
El SDK gestiona el flujo de Apple Pay automáticamente. Cuando el cliente completa la autorización de Apple Pay, el pago se procesa de inmediato.Solicitar información de contacto
Puedes configurar qué campos de contacto solicita Apple Pay al cliente directamente desde el Checkout Builder. Los campos disponibles son:- Teléfono
- Nombre del titular
- Dirección de facturación
- Dirección de envío
Cada campo obligatorio adicional agrega un paso extra a la hoja de pago de Apple Pay, lo que aumenta la fricción para el cliente. Esto puede afectar negativamente las tasas de conversión. Yuno recomienda habilitar solo los campos estrictamente necesarios para tu negocio o tus requisitos regulatorios.
El nombre del titular (nombre del titular de la tarjeta) está deshabilitado por defecto en Apple Pay, a diferencia de las tarjetas, donde está habilitado por defecto. Habilítalo desde el Checkout Builder si tu integración lo necesita.
Próximos pasos
- Pagos recurrentes. Transacciones iniciadas por el cliente y por el comercio con un token almacenado en el vault.
- Express checkout. Desglose del pedido, métodos de envío y actualizaciones de la dirección de envío en la hoja de pago.
- Filtros de tarjetas y datos útiles. Filtra las tarjetas elegibles, lee el BIN del DPAN desde el token de un solo uso y gestiona las cancelaciones.