Guía de integración WebCheckout

1. Pasarela Brinks

Descripción general

La pasarela Brinks es una plataforma de pago que permite a los vendedores recibir pagos en efectivo, para esto cuenta con dos métodos de pago, Recaudo en Punto y Recaudo Domiciliado.

Nuestra plataforma permite llegar a muchos clientes que no están bancarizados o que prefieren realizar sus transacciones en efectivo.

Con Brinks al ser en efectivo no tiene que capturar ni almacenar información de tarjetas de crédito en su sitio web ni certificarse lo que hace el proceso de integración más sencillo y rápido para los desarrolladores.

Para brindar una mayor seguridad en las transacciones están nunca deben realizarse de manera anónima, es por esto que para poder realizar pagos en Brinks es necesario crear un usuario, este usuario puede consultar las transacciones que ha realizado, agregar y administrar las direcciones de recaudo y generar reportes de sus compras.

Los vendedores cuentan con un módulo donde pueden generar reportes, obtener los datos de configuración los diferentes tipos de integración, para poder integrarse es necesario que los vendedores sean creados en la plataforma de Brinks.

2. Medios de recaudo

Recaudo Domiciliado

Es el proceso por el cual un recurso logístico se dirige hasta la ubicación en que se realiza la solicitud o la ubicación que determine el cliente y recauda a domicilo, estos procesos son seguros y una vez el recurso recaude el dinero se notifica al comercio para que realice el despacho de los productos o servicios adquiridos por el cliente del comercio.

Recaudo en Punto

Es el proceso por el cual un cliente genera una solicitud y de acuerdo a una ubicación ingresada se le muestran los puntos de recaudo cercanos a su ubicación donde se puede dirigir a realizar el pago, en cuanto registra el pago en uno de estos puntos aliados de Brinks se notifica al comercio, cabe destacar que los puntos de recaudo varían de país a país (Contacte a su ejecutivo de cuenta para obtener más información de nuestras redes aliadas).

3. Integración WebServices Comercios

Formulario de botón de pago

Con la opción de integración de WebCheckout o boton de pago los comercios/vendedores pueden agregar el botón de pago en su página web, si lo desean pueden integrarlo a un carro de compras o a un recaudo recurrente en el sitio web del comercio, es necesario tener presente que se debe generar un id de transacción diferente para cada transacción que se desee recaudar, para poder integrarse el comercio debe ser registrado en la plataforma de Brinks en el cual se le asigna un id (‘commerce id’) y una llave (‘signature key’).

http://gateway.devel.logisticappweb.com

El servidor de producción es el siguiente:

http://gatewaycashco.logisticappweb.com

Formulario de pago checkout del comercio

<form action="http://gateway.devel.logisticappweb.com/" method="POST">
<input type="hidden" name="amount" value="180801">
<input type="hidden" name="commerce_id" value="145612">
<input type="hidden" name="transaction_id" value="91">
<input type="hidden" name="iva_ammount" value="34352.19 ">
<input type="hidden" name="base_ammount" value="146448.81">
<input type="hidden" name="signature" value="8c78ba5ab49628139132s1df654fs3213f0a4253dec26021206212065db">
<input type="hidden" name="description" value="260|B00LM0THQK 260|B01GGS93AW ">
<input type="hidden" name="address" value=" Bogotá - Bogotá D.c. , Colombia">
<input type="hidden" name="products[0][name]" value="Producto1">
<input type="hidden" name="products[0][price]" value="50000">
<input type="hidden" name="products[0][img]" value="www.commerce.com/imagenes/ejemplo.png">
<input type="submit" value="Submit">
<form>
CAMPO TIPO TAMAÑO DESCRIPCIÓN
ammount Numérico 11 valor total de la transacción
commerce_id Numérico 11 Id del comercio
transaction_id Alfanumérico 250 referencia del comercio,unica por transacción
iva_ammount Numérico 11 Valor del iva 19% para colombia, caso de no tener iva enviar en 0
base_ammount Numérico 11 Valor base antes del iva
signature Alfanumérico 500 Es la firma digital creada para cada uno de las transacciones.
description Alfanumérico 250 Resumen de la compra
address Alfanumérico 250 Dirección residencia
products[key][name] Alfanumérico 50 Nombre producto
products[key][price] Numérico 11 Precio del producto
products[key][image] Alfanumérico 500 Url imagen del producto

Generar firma

Para la validación de autenticidad de transacción se debe generar la firma “signature” Consiste en una cadena de caracteres a la cual se le aplica algoritmo

SHA256 commerce_id~transaction~ammount~signature_key

Suponiendo que:

commerce_id = 99
transaction = AF99
ammount = 56000
signature_key = 8c78ba5ab49628139132s1df654fs3213f0a4253dec260212065db

La cadena tendría la siguiente estructura:

99~AF99~56000~8c78ba5ab49628139132s1df654fs3213f0a4253dec260212065db

La página de confirmación permite actualizar la base de datos del comercio, esta no incluye código HTML, debe ser obligatoria ya que cuando se confirme una transacción en alguna red de recaudo se enviara una petición HTTP POST confirmando el estado de la misma.

5b47c75f5c0c2868cc722e037fb5ff13d9e788523a6f0b27b437cc6229f85892

Página de confirmación

La página de confirmación permite actualizar la base de datos del comercio, esta no incluye código HTML, debe ser obligatoria ya que cuando se confirme una transacción en alguna red de recaudo se enviara una petición HTTP POST confirmando el estado de la misma.

Variables enviadas página de confirmación:

CAMPO TIPO TAMAÑO DESCRIPCIÓN
transaction_gateway_id Numérico 11 id de la transacción en la plataforma gateway
ammount Numérico 11 Valor total de transacción
transaction_date Fecha 19 fecha de la transacción en el siguiente formato yyyy-MM-dd HH:mm:ss
transaction Alfanumérico 250 Referencia de transacción del comercio
state Numérico 1 identificador del estado
state_description Alfanumérico 50 Descripción del estado
signature Alfanumérico 500 firma SHA256

Estados de la transacción:

1 = GENERADO
2 = PAGADO
3 = VENCIDO
4 = PENDIENTE

Página de respuesta

Al finalizar una transacción la plataforma Brinks enviará al pagador a la página de respuesta. A esta página nuestro sistema envía información sobre el estado de una transacción a través del método HTTP GET. Las variables enviadas por son la mismas de la página de confirmación.

Ejemplo url GET

www.comercio.com?amount=56000&transaction_date=2018-04-01_14:00:00&description=prueba&transaction=AF99&state=1&state_description=PAGADO

Cabe destacar que esta pagina no es transaccional si no informativa, sobre esta página no se deben actualizar los estados de las transacciones, ya que por el método de envío de información puede ser cambiada fácilmente por el usuario, la única página con la que se deben actualizar los estados de las transacciones es con la página de confirmación.


$

Solicita efectivo
domiciliado