Token de Uso Único
A continuación, describimos los pasos de cómo crear una compra con un usuario anónimo.
Capturar la información de la tarjeta
El primer paso es obtener el token de la tarjeta del cliente. Para esto, puede invocar el Formulario de Checkout en el último paso del carrito de compras. Recuerde que tiene que obtener el Formulario de Checkout a través de la librería JavaScript de Bamboo Payment. De forma alternativa, peude utilizar la Tokenización Directa si su comercio cumple la con normativa PCI.
Este formulario se muestra dentro de un iframe en su página y solicita los datos de la tarjeta.
Info
Si utiliza el identificador del Medio alternativo, no requiere realizar este paso y debe incluir el PaymentMediaId.
Invocando el formulario de Checkout Form
La librería JavaScript PWCheckout tiene las propiedades para personalizar su apariencia de acuerdo a los requerimientos del comercio. Una vez invoque el formulario de Checkout y el cliente ingrese los datos, puede obtener el token asociado con la tarjeta.
Utilizando la Tokenización Directa
Debido a que el usuario no está registrado en su comercio, debe invocar el método para crear el token para usuarios no registrados.
Info
El token generado utilizando cualquiera de los métodos mencionados previamente corresponde a un One Time Token (OTT) válido por una única vez y duración de 10 minutos.
Crear una Compra Básica
Debe enviar el token recién obtenido desde el navegador o la aplicación móvil al servidor de aplicaciones para crear la transacción de compra.
Desde el servidor, invoque el método Crear una Compra, incluyendo el objeto Purchase con el token y los datos de la transacción adicionales.
{
"TrxToken": "OT_01_kYv0qTHckRiZ4wjCz5NguZRuwFLSIrQc4jiYpVJ8SzQ_",
"Order": "17030613595101621fb",
"Amount": 123456,
"Currency": "USD",
"Capture": true,
"TargetCountryISO":"CL",
"PaymentMediaId":106
}
Los campos PaymentMediaId y TrxToken son opcionales, pero es obligatorio enviar uno dependiendo del flujo que quiere utilizar.
PaymentMediaId: Identificador de medio de pago alternativo (transferencia, efectivo y procesamiento que requiere redirección del cliente). Puede obtener este identificador consultando la sección Medios de pago por país.
TrxToken: Puede generar el token y transaccionar enviándolo en este campo.
Diagrama de secuencia del flujo de pago
El siguiente diagrama de secuencia lista los pasos en el proceso de pago.
En el flujo anterior, se hacen las siguientes llamadas:
- 10 -
HTTP/POST(server to server):{EnvironmentAPI}/v1/api/purchase - 12 -
HTTP/GET(server to server):{EnvironmentAPI}/v1/api/customer/{{customer-id}}
