Cash Payments

Cash payments in Peru allow payers to complete their purchases in cash through local collection networks such as BCP, Interbank, BBVA, and Caja systems.

When this payment method is selected, Bamboo generates a voucher containing the payment details, including amount, reference code, and expiration date. The payer must present this voucher and pay the specified amount in cash at any supported location. Once the payment is confirmed by the network, Bamboo automatically updates the transaction status through its asynchronous notification system.

↩️
Redirect Flow for Cash
This payment method uses a Redirect flow.
The API response includes an Action object with a URL for the payment voucher.
The purchase remains in Pending status until the payer completes the cash payment at the selected collection network.

Request parameters

The following parameters are required specifically for this payment method.
Refer to the Create a Purchase guide for standard fields and authentication rules.

Property	Type	Description
`PaymentMethod`	`string`	Must be one of the available cash payment codes (e.g. `BCP`, `IBC`, `BBV`, etc.). Refer to the Payment Methods section for Peru.
`TargetCountryISO`	`string`	Destination country. Must be `PE`.
`Customer` → `Email`	`string`	Payer’s email address. Required.
`Customer` → `FirstName`	`string`	Payer’s first name. Recommended
`Customer` → `LastName`	`string`	Payer’s last name. Recommended
`Customer` → `DocumentNumber`	`string`	Payer’s identification number. Recommended
`Customer` → `DocumentType`	`string`	Use a valid value from the Document types table. Optional.
`Customer` → `PhoneNumber`	`string`	Mobile or landline number. Optional.
`Customer` → `Address` → `Country`	`string`	Payer’s country. Optional.
`Customer` → `Address` → `State`	`string`	Region or department. Optional.
`Customer` → `Address` → `City`	`string`	City of residence. Optional.
`Customer` → `Address` → `AddressDetail`	`string`	Additional details such as street, number, or between streets. Optional.
`MetaDataIn` → `PaymentExpirationInMinutes`	`number`	Expiration time for the voucher, in minutes. The API applies a default value if omitted. Optional.

Request example

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

{
  "PaymentMethod": "BCP",
  "Order": "PE-CASH-0001",
  "Amount": 5000,
  "Currency": "PEN",
  "Description": "Compra en efectivo - prueba",
  "TargetCountryISO": "PE",
  "Customer": {
    "FirstName": "Lucía",
    "LastName": "Fernández",
    "Email": "[email protected]",
    "DocumentType": "DNI.PE",
    "DocumentNumber": "12345678",
    "PhoneNumber": "987654321",
    "ReferenceCode": "PE-REF-001"
  },
  "MetaDataIn": {
    "PaymentExpirationInMinutes": 1440
  }
}

Response parameters

The API returns the purchase with status Pending and includes the information required for the payer to complete the payment at the selected collection network.

Property	Type	Description
`Action` → `URL`	`string`	URL of the voucher or payment page where the payer can view or print the payment details.
`MetadataOut` → `PaymentCode`	`string`	Reference code identifying the cash transaction.
`MetadataOut` → `PaymentExpirationDate`	`string`	Expiration date of the voucher. Format: `DD/MM/YYYY`.
`MetadataOut` → `AgreementCode`	`string`	Identifier for the agreement between Bamboo and the physical payment network.

For a detailed explanation of all response elements, refer to the Response parameters section of the Purchase creation guide.

Response example

{
    "TransactionId": "135483816503424192",
    "Result": "COMPLETED",
    "Status": "PENDING",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2025-01-08T20:44:19.039",
    "AuthorizationDate": "2025-01-08T20:44:19.088",
    "AuthorizationCode": "429801",
    "Amount": 378,
    "Currency": "PEN",
    "Installments": 1,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.stage.bamboopayment.com/Purchase/135483816503424192",
    "MetadataOut": {
        "AuthorizationCode": "429801",
        "OperationId": "345231",
        "TransactionNumber": "802092"
    },
    "Action": null,
    "PaymentMethod": {
        "Brand": "Bcp",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "PhysicalNetwork",
        "Expiration": null,
        "Last4": null
    }
}

Available payment networks

The following networks are available for cash payments in Peru.
Each network supports in-person payments using the voucher generated by the API.

Logo	PaymentMethod	Description
	`BCP`	Banco de Crédito del Perú
	`ARC`	Caja Arequipa
	`CSC`	Caja Cusco
	`HCC`	Caja Huancayo
	`ICC`	Caja Ica
	`PIC`	Caja Piura
	`TNC`	Caja Tacna
	`TRC`	Caja Trujillo
	`IBC`	Interbank
	`WUC`	Western Union
	`BBV`	BBVA

Discover the API

Once you’re familiar with how to create a purchase, you can test your integration using our API Reference:

Country Requirements

See what documents, currencies, and formats apply per country and payment method.

Create a Payment

Explore the request and response parameters in the API Reference.

Error Codes

Understand the possible error responses and how to handle them.