Pagos en Efectivo

Aprenda a integrar su solución para procesar pagos en efectivo usando Pago Express.

Nota

Solo ofrecemos soporte para comercios en Paraguay a través del modelo Gateway, y les enviamos la factura desde Uruguay.

Pago Express

Pago Express es un popular método de pago para pagar facturas y servicios en Paraguay, ofreciendo comodidad y accesibilidad en todo el país. El cliente necesita proporcionar el código de pago en una sucursal física de Pago Express y completar el pago. Luego, Pago Express nos notifica, y nosotros informamos al comercio.

Parámetros del Request

Es necesario incluir campos específicos para que este método de pago funcione correctamente. Consulte el artículo operación de compra para obtener información detallada sobre la autenticación, los idiomas de la respuesta y los parámetros de compra básica como el monto y la moneda.

Propiedad	Tipo	¿Obligatorio?	Descripción
`PaymentMethod`	`string`	Sí	Consulta el identificador en la tabla de Medios de pago.
`TargetCountryISO`	`string`	Sí	Indica el país destino.
`Customer` → `Email`	`string`	Sí	Correo electrónico del cliente.
`Customer` → `FirstName`	`string`	Sí	Nombre del cliente.
`Customer` → `LastName`	`string`	Sí	Apellido del cliente.
`Customer` → `DocumentType`	`string`	No	Tipo de documento del cliente. Consulte la tabla de tipos de documento para ver los posibles valores.
`Customer` → `DocumentNumber`	`string`	No	Número de documento del cliente.
`Customer` → `PhoneNumber`	`string`	No	Número de teléfono del cliente.
`Customer` → `Address` → `Country`	`string`	No	País del cliente.
`Customer` → `Address` → `State`	`string`	No	Estado del cliente.
`Customer` → `Address` → `City`	`string`	No	Ciudad del cliente.
`Customer` → `Address` → `AddressDetail`	`string`	No	Detalle de la dirección del cliente.
`Customer` → `Address` → `PostalCode`	`string`	No	Código postal del cliente.
`MetaDataIn` → `PaymentExpirationInMinutes`	`numeric`	No	Configure la validez de la deuda generada utilizando este campo, especificando la duración en minutos. La API aplica un valor por defecto si no proporciona esta información.

Ejemplo del Request

{
    "PaymentMethod": "PEX",
    "Order": "12345678",
    "Amount": 10000,
    "TargetCountryISO": "PY",
    "MetadataIn": {
        "PaymentExpirationInMinutes": "43800"
    },
    "Currency": "USD",
    "Capture": true,
    "Customer": {
        "FirstName": "Jaime",
        "LastName": "Benitez",
        "PhoneNumber": "090000001",
        "Email": "jbenitez@mail.com",
        "DocumentNumber": "1223334444",
        "DocumentType": "RUC.PY"
    }
}

Parámetros del Response

En la respuesta, se encuentra el parámetro MetadataOut.PaymentCode con el número de referencia de la deuda generada que el cliente debe presentar en una agencia de Pago Express para pagar la deuda. Además, el parámetro MetadataOut.PaymentExpirationDate muestra la fecha de expiración en formato ISO 8601 (AAAA-MM-DDTHH:MM:SS).

Ejemplo del Response

{
    "TransactionId": "128598955264065792",
    "Result": "COMPLETED",
    "Status": "PENDING",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2024-12-20T20:46:20.199",
    "AuthorizationDate": "2024-12-20T20:46:20.674",
    "AuthorizationCode": "",
    "Amount": 1000,
    "Currency": "PYG",
    "Installments": 1,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.bamboopayment.com/Purchase/128598955264065792",
    "MetadataOut": {
        "PaymentCode": "1244788",
        "PaymentMerchantId": "772",
        "PaymentExpirationDate": "2023-10-14T03:14:54-03:00"
    },
    "Action": null,
    "PaymentMethod": {
        "Brand": "PagoExpress",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "PhysicalNetwork",
        "Expiration": null,
        "Last4": null
    }
}

Última modificación 20 de febrero de 2025