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.
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.
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).
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 |
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
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
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.