Envio único de Transacción

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.

Conexión VPN

Una conexión VPN no es requerida por PAGO46 entre PAGO46 y el proveedor. La autenticación HMAC, protección de credenciales y comunicación HTTPS se considera adecuado para proteger la comunicación. Si el proveedor requiere de una conexión VPN debe contactar a su ejecutivo comercial y contacto técnico de PAGO46.

Enviar Transacción#

Cuando el proveedor de transacciones recibe una transacción o transferencia y quiere registrarla en PAGO46 esta debe ser enviada para completar el registro y posteriormente ser procesada.

Path: /new_transaction
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ón se envió exitosamente.

{
    "code": 200,
    "message": "Transaction `bank_transaction_id` registered successfully" 
    "status": "successful"
}

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

{
    "code": 400,
    "message": [
        {
            "detail": {
                "Validator": "Provided bank_country_currency_id `bank_country_currency_id` does not exist"
            },
            "transaction": {
                "amount": "100.00",
                "bank_country_currency_id": "bank_country_currency_id,
                "bank_transaction_id": "1",
                "beneficiary_email": "",
                "beneficiary_name": "John Doe",
                "creation_date": "20210131",
                "description": "test_txn1",
                "document_id": "123456789",
                "extra_document_id": "101234567890",
                "payer_email": "",
                "payer_name": "John Wick",
                "payment_method": "payment_provider",
                "tax_amount": "10"
            }
        }
}