Envio de Transacción en Bulto

Autenticación HMAC

Toda la comunicación con API de PAGO46 requiere de autenticación HMAC, favor leer la sección Autenticación HMAC antes de continuar con la integración.

Siempre Server-side Requests

Las credenciales (provider key, provide secret y bank country currency id) nunca deben ser expuestas a usuarios finales no autorizados y toda la comunicación HTTP entre el Proveedor y PAGO46 debe hacerse Server-side, nunca desde el browser o app del usuario final. Exponer las credenciales puede provocar serias vulnerabilidades de seguridad para el comercio y sus consumidores.

Envio de Transacción por bulto#

Cuando el proveedor de transacciones recibe múltiples transacciones o transferencias y quiere registrarlas en PAGO46 estas deben ser enviadas para completar su registro y posteriormente ser procesadas.

Path: /bulkTransaction
Method: POST

Parámetros Header#

Nombre	Tipo	Descripción	Requerido
`message-hash`	{hash}	Hash HMAC SHA256 de autenticación. Más información.	SI
`message-date`	{date}	Unix milisegundos timestamp mismo que se usó para generar Hash	SI
`provider-key`	{provider-key}	Key del proveedor de pagos	SI

Parámetros Body#

Nombre	Tipo	Descripción	Requerido
`amount`	String	Monto de la transacción en formato String con formato 2f. Ejemplo: `100.00`	SI
`bank_country_currency_id`	{bank_country_currency_id}	Código único del proveedor provisto por PAGO46.	SI
`bank_transaction_id`	String	Identificador único de la transacción.	SI
`beneficiary_email`	String	Email del usuario o comercio que recibe la transacción.	NO
`beneficiary_name`	String	Nombre del usuario o comercio que recibe la transacción.	NO
`creation_date`	String	Fecha de la transacción. Formato debe ser `%Y%m%d`	SI
`description`	String	Descripción de la transacción.	NO
`document_id`	String	Documento de identidad del usuario.	SI
`external_contract`	String	Sólo si aplica.	NO
`extra_document_id`	String	Número de Documento de identidad de registro tributario del usuario.	NO
`payer_email`	String	Email del usuario que realiza la transacción.	NO
`payer_name`	String	Email del usuario que realiza la transacción.	NO
`payment_method`	String	Método de pago utilizado. Ejemplo: `bank_transfer`.	SI
`tax_amount`	String	Registro de comisión.	NO

Response#

Ejemplo#

OK - 201 o 202 : Transacciónes fueron enviadas exitosamente.

{
   "status": successful,
   "code": 202,
   "message": 'XX transactions were successfully logged'
}

- `Validation Error` - `422` - `400`: Error de validación.

{ "code": 400, "message": "Authentication error: WRONG HASH", "status": "error" }

{ "code": 422, "message": [ { "Validator": "Provided bank_country_currency_id d9e41e37-3ff4-4dbc-82b6-1ded336910dc does not exist" } ], "status": "Unprocessable Entity" }