Pagos en Efectivo

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

PuntoXpress

PuntoXpress es una red de cobro en efectivo con cobertura regional en América Central. Cuando los clientes de las plataformas de comercio electrónico realizan compras en sus sitios web, el comercio nos solicita que generemos una deuda. Posteriormente, el cliente acude a un punto de cobro de PuntoXpress, comprueba la deuda asociada a la referencia y realiza el pago. Luego, PuntoXpress nos notifica y nosotros reportamos 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": "PNX",
    "Amount": 10000,
    "Currency": "CRC",
    "TargetCountryISO": "CR",
    "Capture": true,
    "Customer": {
        "Email": "john@mail.com",
        "FirstName": "John",
        "LastName": "Doe",
        "PhoneNumber": "12345672",
        "DocumentNumber": "139899768",
        "DocumentType": "CI.CR"
    },
    "Description": "Prueba PuntoXpress"
}

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 PuntoXpress 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": "79632697147789184",
    "Result": "ACTION_REQUIRED",
    "Status": "PENDING",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2024-08-07T17:51:54.620",
    "AuthorizationDate": null,
    "AuthorizationCode": null,
    "Amount": 100000,
    "Currency": "CRC",
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.stage.bamboopayment.com/Purchase/79632697147789184",
    "MetadataOut": null,
    "MetaDataIn": {
        "PaymentExpirationInMinutes": "7200",
        "PaymentCode": "1133713",
        "PaymentMerchantId": "772"
    },
    "Action": null,
     "PaymentMethod": {
        "Brand": "PuntoXpress",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "PhysicalNetwork",
        "Expiration": null,
        "Last4": null
    }
}

Última modificación 20 de febrero de 2025