Apple Pay

Introducción

Paylands ofrece la posibilidad de que tu comercio ofrezca Apple Pay como forma de obtener los datos de tarjeta de un cliente. Independientemente de la forma en la que lo vayas a ofrecer, es necesario que primero te registres como comercio en Apple Pay para obtener tu propio ID de comercio que más tarde se asociará a tu cuenta de Paylands.

La forma más sencilla de integrarlo es a través de la carta de pago, donde además de la posibilidad de que el usuario introduzca los datos de su tarjeta manualmente, se incluye el botón de Apple Pay para que el usuario pueda elegir cómo introducir su tarjeta. Alternativamente, también puede integrarse en tu aplicación web o móvil. En la sección de integración directa se proporciona más información.

A pesar de que Apple Pay ofrece tarjetas de prueba, estas no se pueden utilizar para llevar a cabo pruebas en el entorno Sandbox. Solamente soportamos el entorno Producción.

A continuación se muestra un ejemplo de cómo Apple Pay se integra en la carta de pago cuando se muestra exclusivamente como forma de pago, o junto con el resto del formulario:

Apple Pay exclusivo Apple Pay opcional

Registrar tu comercio en Apple Pay

Si ya has realizado este paso, puedes saltar a la sección de Configurar Apple Pay en Paylands. Si tienes dudas puedes consultar también la Guía de configuración oficial de registro con Apple Pay. Necesitas disponer de un Apple ID y tener una cuenta de desarrollador de Apple. Si todavía no la tienes, puedes darte de alta aquí. También es necesario disponer de un Mac para poder generar un certificado CSR.

1. Crear el certificado de identidad del comercio

En primer lugar, crea un nuevo certificado de tipo Merchant ID certificados.

Certificados

Introduce un nombre para este identificador y descripción.

Registrar Merchant ID

Con esto, accederás al panel de configuración de tu Merchant ID, deberás crear el certificado de identidad del comercio siguiendo el proceso guiado y añadir un dominio donde se mostrará el botón de Apple Pay.

Panel de configuración del Merchant ID

Para poder crear tus certificados, Apple te solicitará un archivo CSR que debe ser creado desde un Mac, si pulsas en learn more, Apple te indicará como crearlo.

Certificado CSR

Este certificado deberás conservarlo para poder renderizar el botón de Apple Pay en tu aplicación móvil.

2. Crear el certificado de procesamiento del pago

Siguiendo un proceso similar al anterior, crea el certificado del procesamiento del pago. Deberías obtener el apple_pay.cer al finalizar el proceso.

Configurar Apple Pay en Paylands

Para configurar Apple Pay debes seguir los siguientes pasos:

Registra tu comercio en Apple Pay y guarda tu id de comercio.
Dirígete a tu perfil de cliente en el panel de Paylands y accede a la pestaña Métodos de pago alternativos.
Introduce tu id de comercio, un nombre con el que identificar a tu comercio en Paylands, el host del sitio web desde donde se inicia el proceso de pago y el código de país.

Configuración métodos de pago alternativos

Ponte en contacto con el soporte de Paylands para utilizar Apple Pay en cualquiera de sus modalidades.
Estas son las tarjetas SANDBOX de test soportadas.

Integración directa

Integración con dispositivos Apple

Si tienes una app compatible con Apple, debes cargar el botón de Apple Pay en la página de pago. La documentación de Apple Pay tiene toda la información que necesitas para integrarlo. Una vez que el usuario confirme la tarjeta con la que desea pagar, se lanzará un evento cuyo payload debe ser proporcionado a nuestra API en el endpoint pago mediante wallet para proceder con el pago.

Para ello será necesario que compartas con Paylands los certificados necesarios para el desencriptado:

Ejecuta los siguientes comandos:

openssl ecparam -out private.key -name prime256v1 -genkey
openssl req -new -sha256 -key private.key -nodes -out request.csr

Asegurate de tener un ID de comercio. Navega a Identifiers => Merchant IDs para asegurarte de que ya tienes uno, sino, crealo.

Navega a Certificates => All, después haz click en el + en la esquina superior-derecha. Selecciona Apple Pay Payment Processing Certificate y sube el fichero .csr creado (request.csr).

Descarga el fichero (apple_pay.cer). Este fichero es necesario para crear la llave.

openssl x509 -inform DER -outform PEM -in apple_pay.cer -out temp.pem
openssl pkcs12 -export -out key.p12 -inkey private.key -in temp.pem

Debes proteger con una contraseña tu fichero .p12. Elige una contraseña segura.

Ahora tienes los 2 ficheros necesarios para poder desencriptar tokens de Apple Pay, pero antes de ello, es necesario convertirlos a ficheros .pem

openssl x509 -inform DER -outform PEM -in apple_pay.cer -out certPem.pem
openssl pkcs12 -in key.p12 -out privatePem.pem -nocerts -nodes

Al final, deberás tener un certificado (certPem.pem) similar a este:

Y un certificado (privatePem.pem) similar a este:

Bag Attributes
    localKeyID: 90 C8 20 E7 8A 2A E5 7E 33 06 FD C5 43 47 9F 15 2F DE 73 90
Key Attributes: <No Attributes>
-----BEGIN PRIVATE KEY-----
8nG5lEs5hYJ2WG9Yo39m1gyCHeNse5sOrph9Dq7tro5mO+nX3XaVaIi3MHFl9Hq6
YwKcj8BAm4LvxkCLODZVIsqYZbNTzyTWbKiz7G53Rt6XqFaQVlqlSxvA97SUfq62
qDRXQRMETBev1j7Y1w/v2K0CIAlnnXPVX52g5FTadoFyVq2a91sA4ao4
-----END PRIVATE KEY-----

Comparte estos certificados junto con tu ID de comercio (merchant id) con Paylands para poder utilizar Apple Pay.

Apple Pay

Introducción​

Registrar tu comercio en Apple Pay​

1. Crear el certificado de identidad del comercio​

2. Crear el certificado de procesamiento del pago​

Configurar Apple Pay en Paylands​

Integración directa​

Integración con dispositivos Apple​