Cash Payments

This page describes Uruguay-specific requirements for processing cash payments under the Gateway 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.

Available Cash Networks

RedPagos

RDP

RedPagos is one of Uruguay’s main payment networks, allowing customers to pay bills and online purchases in cash through more than 450 physical locations nationwide.

Abitab

ABT

Abitab operates a nationwide network of collection points where payers can complete cash transactions, including e-commerce purchases, deposits, and service payments.

Request parameters

Only fields specific to Gateway 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 acquirer in this table. -> `RDP` - `ABT`
`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 the selected network (RedPagos or Abitab). 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.

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 Mexico:

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 gracefully.