PagoEfectivo

PagoEfectivo allows payers to complete their purchases in cash or through their online banking app using a unique payment code (CIP). When this method is selected, Bamboo generates the CIP and a payment URL where the payer can view the voucher and complete the payment.

The transaction remains in Pending status until the payment is confirmed by PagoEfectivo and updated asynchronously by Bamboo.

↩️
Redirect Flow for PagoEfectivo
This payment method uses a Redirect flow.
The API response includes the CIP and a payment URL that the payer can use to complete the transaction.

Request parameters

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

Property	Type	Description
`PaymentMethod`	`string`	Must be `PEC`. Refer to the Payment Methods table. Required.
`TargetCountryISO`	`string`	Must be `PE`. Indicates the destination country. Required.
`Customer` → `Email`	`string`	Payer’s email address. Required.
`Customer` → `FirstName`	`string`	Payer’s first name. Required.
`Customer` → `LastName`	`string`	Payer’s last name. Required.
`Customer` → `PhoneNumber`	`string`	Payer’s phone number, including country code (e.g., `+51971516229`). Required.
`Customer` → `DocumentType`	`string`	Use one of the valid values from the Document types table. Optional.
`Customer` → `DocumentNumber`	`string`	Identification number according to the selected document type. Optional.
`Customer` → `Address` → `Country`	`string`	Payer’s country. Optional.
`Customer` → `Address` → `State`	`string`	Department or region. Optional.
`Customer` → `Address` → `City`	`string`	City of residence. Optional.
`Customer` → `Address` → `AddressDetail`	`string`	Full address details. Optional.
`Customer` → `Address` → `PostalCode`	`string`	ZIP or postal code. Optional.
`MetaDataIn` → `PaymentExpirationInMinutes`	`number`	Defines how long the payment remains valid (in minutes). Minimum: 10 minutes. Maximum: 6 months. The API applies a default value if not provided. Optional.

Request example

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

{
  "PaymentMethod": "PEC",
  "Order": "PE-PEC-0001",
  "Amount": 100,
  "Currency": "PEN",
  "Description": "Compra con PagoEfectivo - prueba",
  "TargetCountryISO": "PE",
  "Customer": {
    "FirstName": "Lucía",
    "LastName": "Fernández",
    "Email": "[email protected]",
    "PhoneNumber": "+51987654321",
    "DocumentType": "DNI.PE",
    "DocumentNumber": "12345678",
    "ReferenceCode": "PE-REF-001",
    "Address": {
      "Country": "PE",
      "City": "Lima",
      "State": "Lima",
      "PostalCode": "15046",
      "AddressDetail": "Av. Arequipa 1234, Miraflores"
    }
  },
  "MetaDataIn": {
    "PaymentExpirationInMinutes": 1440
  }
}

Response parameters

The API returns the purchase in Pending status and includes the CIP (payment code) generated by PagoEfectivo along with its expiration date and payment URL.

Property	Type	Description
`MetadataOut` → `PaymentCode`	`string`	Unique CIP (Código de Identificación de Pago) generated by PagoEfectivo.
`MetadataOut` → `PaymentExpirationDate`	`string`	Expiration date of the CIP. Format: ISO 8601.
`MetadataOut` → `PaymentUrl`	`string`	URL of the voucher where the payer can view or print the CIP and payment instructions.

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

Response example

{
    "TransactionId": "135483617504670912",
    "Result": "COMPLETED",
    "Status": "PENDING",
    "ErrorCode": null,
    "ErrorDescription": null,
    "Created": "2025-01-08T20:43:31.580",
    "AuthorizationDate": "2025-01-08T20:43:32.263",
    "AuthorizationCode": null,
    "Amount": 378,
    "Currency": "PEN",
    "Installments": 1,
    "TaxableAmount": null,
    "Tip": null,
    "Url": "https://api.stage.bamboopayment.com/Purchase/135483617504670912",
    "MetadataOut": {
        "PaymentCode": "1691391",
        "PaymentUrl": "https://pre1a.payment.pagoefectivo.pe/A7272995-6F97-422E-BB5B-9D0A25BB47EF.html",
        "PaymentExpirationDate": "2025-01-08T15:58:31-05:00"
    },
    "Action": null,
    "PaymentMethod": {
        "Brand": "PagoEfectivoPeru",
        "CardOwner": null,
        "Bin": null,
        "IssuerBank": null,
        "Type": "PhysicalNetwork",
        "Expiration": null,
        "Last4": null
    }
}

Buyers can complete their payment in cash or through their bank or wallet app using the CIP code or the QR code displayed on the voucher.
Once the payment is confirmed by PagoEfectivo, Bamboo automatically updates the transaction status to Completed.

Discover the API

Country Requirements

Review country-specific requirements, documents, and supported currencies.

Create a Payment

Explore complete request and response examples in the API Reference.

Error Codes

Review all possible error responses and how to handle them.