Redpagos

This page describes Uruguay-specific requirements for processing cash payments under the Payfac model. Cash payments allow customers to generate a coupon and complete the transaction in person at a physical payment office.

💡
The purchase status for cash payment methods remains PENDING until the payer completes the transaction at a supported payment office.

Request parameters

Only fields specific to Cash – Uruguay (Payfac) are listed below.
For global fields (Amount, Currency, Order, etc.), see the Create Purchase guide.

Property	Type	Mandatory?	Description
`PaymentMethod`	`string`	Yes	Send the `PaymentMethod` according to the selected Cash Network -> `RDP`
`TargetCountryISO`	`string`	Yes	Indicate the destination country. `UY`
`Customer` → `Email`	`string`	Yes	Customer’s email.
`Customer` → `FirstName`	`string`	No	Customer’s first name.
`Customer` → `LastName`	`string`	No	Customer’s last name.
`Customer` → `DocumentType`	`string`	No	Customer’s document type. Refer to the Document types table to see valid values.
`Customer` → `DocumentNumber`	`string`	No	Customer’s document number.
`Customer` → `PhoneNumber`	`string`	Yes	Customer’s phone number.
`Customer` → `Address` → `Country`	`string`	No	Customer’s country.
`Customer` → `Address` → `State`	`string`	No	Customer’s state/department.
`Customer` → `Address` → `City`	`string`	No	Customer’s city.
`Customer` → `Address` → `AddressDetail`	`string`	No	Customer’s address detail.
`Customer` → `Address` → `PostalCode`	`string`	No	Customer’s postal code.
`MetaDataIn` → `PaymentExpirationInMinutes`	`numeric`	No	Configure the expiration time for the payment (minutes). A default value is applied if not provided.

Request example

To test this endpoint, use the API Reference or the Postman Collection

{
  "PaymentMethod": "RDP",
  "Order": "UY-CASH-1001",
  "Amount": 2500,
  "Currency": "UYU",
  "TargetCountryISO": "UY",
  "Capture": true,
  "Description": "Pago en efectivo - RedPagos",
  "MetaDataIn": {
    "PaymentExpirationInMinutes": 1440
  },
  "Customer": {
    "Email": "[email protected]",
    "FirstName": "Martín",
    "LastName": "Pérez",
    "PhoneNumber": "099111222",
    "DocumentNumber": "12345672",
    "DocumentType": "CI.UY",
    "Address": {
      "Country": "UY",
      "State": "Montevideo",
      "City": "Montevideo",
      "AddressDetail": "La Paz 1020",
      "PostalCode": "11600"
    }
  }
}

💡
The generated coupon can be downloaded from the URL provided in MetadataOut.PaymentBarcodeUrl.
The payer must present this coupon at the selected payment office (Abitab or RedPagos) to complete the transaction.

Response parameters

The API returns the purchase object with the status PENDING, since cash payments are completed only when the customer makes the payment at Redpagos.

For more information on the response parameters, please refer to the Response parameters section of the Purchase creation.

Property	Type	Description
`MetadataOut` → `PaymentBarcodeUrl`	`string`	URL of the coupon (PDF). The payer must present it at the agency to complete the transaction.
`MetadataOut` → `CouponValidity`	`string`	Coupon expiration date in `YYYYMMDD` format.

💡
Payment confirmation may take up to 24 hours, depending on the bank’s processing time.

Response example

{
    "TransactionId": "135849282501621568",
    "Result": "COMPLETED",
    "Status": "PENDING",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2025-01-09T20:56:32.924",
    "AuthorizationDate": "2025-01-09T20:56:38.378",
    "AuthorizationCode": null,
    "Amount": 87302,
    "Currency": "UYU",
    "Installments": 1,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.stage.bamboopayment.com/Purchase/135849282501621568",
    "MetadataOut": {
        "CouponValidity": "20250110",
        "PaymentBarcodeUrl": "https://gateway.stage.bamboopayment.com/purchase-coupons/PW_234375_20250110.pdf"
    },
    "Action": null,
    "PaymentMethod": {
        "Brand": "RedPagos",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "PhysicalNetwork",
        "Expiration": null,
        "Last4": null
    }
}

Discover the API

Learn more about how to create and manage cash-based transactions in Uruguay:

Create a Purchase

Explore the full request and response structure for cash payments.

Country Requirements

See document types, address formats, and currency rules for each country.

Error Codes

Understand error responses and how to handle them.