Integrar Apple Pay

Te contamos cómo integrar Apple Pay a tu solución de Cards.

Introducción

Para sumar Apple Pay a tu solución de Cards, tendrás que completar estas 3 etapas:

1. Firma del acuerdo comercial

El primer paso para ofrecer Apple Pay es acordar y firmar las condiciones comerciales con nosotros. Si todavía no lo hiciste, ponte en contacto con nuestro equipo comercial.

2. Configuración de BIN

Te contamos cómo obtener algunos datos necesarios para completar el formulario y configurar tu BIN para Apple Pay.

👉🏼 Team ID

1. Ingresa al sitio de Apple Developers e inicia sesión con tus credenciales.
2. Desliza hacia abajo hasta "Membership Details".
3. Ahí encontrarás tu Team ID.

👉🏼 ADAM, Apple ID y Bundle ID

1. Ingresa a App Store Connect con tus credenciales.
2. Selecciona “My Apps” y elige la aplicación que corresponda.
3. Ve a la opción "App Information" que está en el menú de navegación de la izquierda y luego a general information.
4. Ahí encontrarás el Apple ID y el Bundle ID.

👉🏼 Acuerdo firmado

Tendrás que firmar un acuerdo para indicarle a Apple que ofrecerás servicios de Tokenización con nosotros. Para hacerlo, ponte en contacto con nuestro equipo de Integraciones.

Importante: podrás firmarlo a mano y escanearlo o hacer una firma digital.

👉🏼 Asset de marketing

Apple solicita que adjuntes al menos una pieza de Marketing publicitando que ofreces servicio de Tokenización con Apple Pay. Además, validará que cumplas con: su Guía de Marketing y assets.

A continuación, te compartimos los assets correspondientes a cada país para que puedas armar tus piezas de marketing:

• Guia de Assets Mexico
• Guia de Assets Colombia
• Guia de Assets Brasil
• Guia de Assets Argentina
• Guia de Assets Perú

También te dejamos algunos ejemplos a modo de referencia:

• Ejemplo mail español 01
• Ejemplo mail español 02
• Ejemplo mail Portugués 01
• Ejemplo mail Portugués 02

3. Ajustes técnicos

Te compartiremos un paso a paso con los ajustes técnicos que tendrás que realizar para soportar Apple Pay en tu aplicación. Al ser una funcionalidad propia de Apple, tendrás que hacer los ajustes en su lenguaje de programación nativo que es Swift.

👉🏼 Agregar el botón para iniciar el flujo

Tendrás que sumar a tu vista de tarjeta un botón que permita iniciar el flujo como en el siguiente ejemplo:

👉🏼 Generar información para aprovisionar una tarjeta usando nuestro endpoint

Para aprovisionar una tarjeta en Apple Pay, lo primero que debes hacer es generar la información que luego tendrás que enviarle a Apple para que tus clientes puedan enrolar sus tarjetas en la billetera. Eso lo haces usando este endpoint.

👉🏼 Aprovisionar el token

Te detallamos un paso a paso de cómo tendrás que aprovisionar un token a la tarjeta de tu cliente.

Paso 1 - Verificar que el dispositivo y tu aplicación sean compatibles con Apple Pay

Paso 2 - Iniciar el flujo

Paso 3 - Construir el objeto

Paso 4 - Notificar al cliente del error

Paso 5 - Obtener la información de la tarjeta

En este paso, te compartimos un ejemplo hardcodeado, pero en tu aplicación tendrás que construir un mecanismo para buscar la información de la tarjeta de tu usuario.

Recuerda que en el paso 3 creamos una variable, let card = cardInformation()y es la que estamos utilizando en este paso.

Para obtener los datos de la tarjeta, tendrás que seguir los pasos de esta documentación.

Paso 6 - Contactar a Apple y a Pomelo

Primero tendrás que llamar a la función PKAddPaymentPassViewControllerDelegate para obtener la información que luego utilizarás para contactarte con nosotros.

Luego, deberás armar el objeto IssuerRequest con la respuesta que obtuviste en el paso anterior y contactarte con nosotros usando este endpoint.

Finalmente, con la respuesta que obtuviste de nuestro endpoint, deberás armar el llamado a Apple para continuar con el flujo de aprovisionamiento usando la función PKAddPaymentPassRequest().

Asegúrate de que la información que recibiste esté encodeada en base64.

Paso 7 - Escuchar el resultado del aprovisionamiento

Documentación Adicional

En caso de que la necesites, te dejamos esta guía de troubleshooting.

Importante:

• Por el momento, puedes usar un único arte de tarjeta por BIN.
• Para el flujo de Manual Provisioning no debes realizar ajustes en tu integración técnica.
• Desde que recibimos el formulario completo y cargamos la configuración en la bandera, deberás esperar al menos 10 días hábiles para que apliquen los cambios.
• Tendrás que compartirnos entre 5 y 20 card-id para que habilitemos esas tarjetas para probar los flujos.
  • Estos card-id deberán corresponder a tarjetas productivas.
  • Cuando hayas validado correctamente que todo funciona conforme a lo esperado, ponte en contacto con nosotros para que podamos habilitar la totalidad de tu BIN para Apple Pay. Este es un proceso que tiene que ser coordinado con la bandera.
• Tendrás que tener registrado el correo electrónico y el número de celular de tus clientes con código de área sin símbolo para poder enviarles el código de verificación de validación de identidad. Ejemplo: 541123456777
  • En caso de que tus clientes no cuenten con información actualizada, podrás actualizarla usando este endpoint.