Introducción a las integraciones: Hosted, Host2Host y JavaScript

Introducción

Addon Payments permite la integración de la pasarela de pago en tu negocio. En esta guía de introducción se hará un primer acercamiento a los siguientes temas: qué tipos de integración hay, qué datos necesitas para empezar a integrar, dónde conseguir dichos datos y los distintos entornos, Staging/Pruebas y Producción.

Tipos de checkout

Addon Payments cuenta con tres (3) formas distintas de integrar el checkout.

Integración Hosted | Seguro

Integración Host2Host | Flexible

Control total sobre el proceso de pago, requiere PCI si manejas datos de tarjeta
Permite acceder a un conjunto completo de solicitudes de administración de las transacciones
Apto para las integraciones de los centros de atención al cliente y proyectos avanzados
Recomendable para métodos de pago alternativos con redirección lista

Integración JavaScript | Personalizable

¿Qué necesitas para empezar a integrar?

Antes de empezar cualquiera de las integraciones, debes reunir una serie de datos necesarios para continuar con el proceso. Además de estos datos, también debes conocer la diferencia entre entornos.

En los siguientes puntos de esta guía encontrarás información sobre ambas cosas.

Datos necesarios para integrar (y dónde obtenerlos)

Antes de comenzar cualquiera de las tres (3) integraciones debes tener a mano los siguientes datos:

merchantId: Es el indicador de tu comercio en la plataforma de Addon Payments.
- Es un código numérico facilitado por Soporte en el correo de bienvenida.
- Tiene entre 4 y 7 dígitos y es común para ambos entornos (Staging/Producción).
- Un ejemplo sería: 14983.
Contraseña de cifrado (merchantPass): Es una clave de tu comercio. Varía según el entorno al que se va a enviar la petición. Se obtiene de varias formas:
- Para el entorno de Staging/Pruebas se envía en el correo de bienvenida. Para recuperarla, consulta la guía de pase a Producción.
- Para el entorno de Producción debes recuperarla a través del Portal BackOffice Addon Payments. Para recuperarla, consulta la guía de pase a Producción.
- La contraseña es en formato PBKDF2 With HmacSHA256. Donde el merchantId es el valor salt y se usan 10000 iteraciones. Por ejemplo:
  - merchantId y Salt: 2150100
  - Contraseña sin codificar: NewPassword123!
  - Iteraciones: 10000
  - Resultado: Odm1hxMXWmkRs9bs3ibrQLs1YUcepvR3JguIzBHt7Sw=

El siguiente dato es necesario únicamente para integraciones en JavaScript:

Contraseña JavaScript (merchantKey): La contraseña de JavaScript es un Identificador Único Universal (UUID) que autoriza la conexión y el renderizado del cajero por JS.
- Debe tener un formato UUID válido. Para recuperarla, consulta la guía de pase a Producción.

Entornos: Staging y Producción

Addon Payments cuenta con dos (2) entornos operativos independientes:

Entorno de Staging/Pruebas:
- Es el primer entorno con el cual entrarás en contacto.
- Tienes a tu disposición un listado de tarjetas para pruebas que permiten realizar transacciones simulando diferentes operativas, tipos de autenticación (frictionless, challenge) y resultados (autorizada, denegada).
- Esto te permite comprobar la correcta gestión de las diferentes casuísticas por parte de tu integración.
- Las tarjetas y cuentas reales no funcionan.
Entorno de Producción:
- Es el entorno en el cual las transacciones tienen efectos contables.
- Únicamente se puede transaccionar con tarjetas y cuentas reales y operativas.

Integraciones

A continuación, tienes una breve descripción del funcionamiento básico de las integraciones.

Hosted

La integración vía Hosted consiste en la redirección del cliente a un formulario de pago (cajero) alojado por Addon Payments. El cliente llega a ese formulario desde tu página web, a través de una redirección desde su navegador o mediante un iframe. Como tu negocio no tiene acceso a los datos del cliente, puedes aceptar pagos sin necesidad de certificación PCI-DSS.

Cuando la transacción finaliza en alguno de los estados (autorizada, denegada, cancelada, etc.):

Tu plataforma recibe una notificación con el resultado de la transacción.
El cliente es redirigido a la URL correspondiente según el resultado de la transacción (autorizada, denegada, cancelada).

El aspecto y la funcionalidad del formulario de pago (cajero) pueden modificarse, ya sea en la configuración de tu comercio o con ciertos parámetros enviados en la petición de pago.

Host2Host (H2H)

La integración por H2H consiste en el envío de peticiones directamente desde tu plataforma de comercio electrónico al endpoint dispuesto por Addon Payments (AP). El proceso es el siguiente:

Tu plataforma de comercio electrónico genera una petición con todos los datos necesarios para realizar la operativa (pago con tarjeta, pago con APM, operación secundaria, etc.).
- Para el pago con tarjeta es necesario incluir los datos de la tarjeta del cliente, o bien una referencia de tarjeta generada previamente.
- En caso de capturar, almacenar o enviar datos de tarjetas, tu comercio debe disponer de certificación PCI-DSS en vigor.

2. Tu plataforma envía la petición al endpoint de AP, el cual devolverá una respuesta que puede ser:

- Requerimiento de redirección:
  - La solución de pago responde con un requerimiento de redirección del cliente a una URL, donde se le solicitará que siga los pasos que le indiquen (autenticación, inicio de sesión, aprobación de la operación, etc.).
  - Si el cliente completa el proceso, tu plataforma de comercio electrónico recibirá una notificación de tipo “Resultado” en la URL de notificación que se haya incluido en la petición formada en el punto 1.
- Resultado:
  - La solución de pago ha autorizado o denegado la transacción y se indica el estado final de la transacción.

3. Tu plataforma de comercio electrónico gestiona la respuesta recibida desde AP con el resultado de la transacción, y actualiza según el estado del pago del pedido.

JavaScript (JS)

La integración por JavaScript consiste en el renderizado del cajero de AP dentro de tu plataforma de comercio electrónico mediante lenguaje JS. Este renderizado se hace en un elemento HTML <div>.

La integración con tu plataforma de comercio electrónico es muy alta. Además, no requiere que tu comercio disponga de certificación PCI-DSS, ya que no tendrás acceso a los datos del cliente.

Nota: Requiere una integración H2H subyacente para la tramitación de las transacciones.

Introducción a las integraciones: Hosted, Host2Host y JavaScript

Introducción

Tipos de checkout

¿Qué necesitas para empezar a integrar?