Skip to main content

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#

NombreTipoDescripciónRequerido
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 HashSI
provider-key{provider-key}Key del proveedor de pagosSI

Parámetros Body#

NombreTipoDescripciónRequerido
amountStringMonto de la transacción en formato String con formato 2f. Ejemplo: 100.00SI
bank_country_currency_id{bank_country_currency_id}Código único del proveedor provisto por PAGO46.SI
bank_transaction_idStringIdentificador único de la transacción.SI
beneficiary_emailStringEmail del usuario o comercio que recibe la transacción.NO
beneficiary_nameStringNombre del usuario o comercio que recibe la transacción.NO
creation_dateStringFecha de la transacción. Formato debe ser %Y%m%dSI
descriptionStringDescripción de la transacción.NO
document_idStringDocumento de identidad del usuario.SI
external_contractStringSólo si aplica.NO
extra_document_idStringNúmero de Documento de identidad de registro tributario del usuario.NO
payer_emailStringEmail del usuario que realiza la transacción.NO
payer_nameStringEmail del usuario que realiza la transacción.NO
payment_methodStringMétodo de pago utilizado. Ejemplo: bank_transfer.SI
tax_amountStringRegistro 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" }