PagoEfectivo

Learn how to integrate your solution to process payments with PagoEfectivo.

Info

The purchase status for PagoEfectivo will remain Pending until the customer completes the payment.

PagoEfectivo Perú

PagoEfectivo provides a network of physical payment centers where your customers can pay their purchases in cash or using their bank app. Your customer can pay giving the debt identifier (CIP) in a physical payment office or using their bank app.

Request parameters

You need to include specific fields for this payment method to work correctly. Check the Purchase operation article for details on authentication, languages of the response, and basic purchase parameters such as amount and currency.

Property	Type	Mandatory?	Description
`PaymentMethod`	`string`	Yes	Find the value in the table Payment Method.
`TargetCountryISO`	`string`	Yes	Indicate the destination country.
`Customer` → `Email`	`string`	Yes	Customer’s email.
`Customer` → `FirstName`	`string`	Yes	Customer’s first name.
`Customer` → `LastName`	`string`	Yes	Customer’s last name.
`Customer` → `DocumentType`	`string`	No	Customer’s document type. Refer to the Document types table to see the possible values.
`Customer` → `DocumentNumber`	`string`	No	Customer’s Document Number.
`Customer` → `PhoneNumber`	`string`	Yes	Customer’s phone number. The phone number format must be `<characteristic>\|<number>`. Example: `+51\|971516229`.
`Customer` → `Address` → `Country`	`string`	No	Customer’s Country.
`Customer` → `Address` → `State`	`string`	No	Customer’s State.
`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 using this field, specifying the duration in minutes. The API applies a default value if you don’t provide this information. The expiration date must be at least 10 minutes and less than six months from the current date (in UTC GMT -5).

Request example

{
	"PaymentMethod": "PEC",
    "Order": "CH2023-001",
	"Amount": 100,
    "Currency": "PEN",
    "TargetCountryISO": "PE",
    "Customer": {
        "FirstName": "Joao",
        "LastName": "Silva",
        "ReferenceCode": "JS-001",
        "PhoneNumber":"+51971516229"
        "DocumentNumber": "12345678901",
        "DocumentType": "DNI.PE",
        "Email": "joao.silva@example.com",
        "Address": {
            "Country": "PE",
            "City": "Lima",
            "State": "SP",
            "PostalCode": "01310-200",
            "AddressDetail": "Avenida Paulista 1000"
        }
    },
	"MetaDataIn": {
        "PaymentExpirationInMinutes": "1440"
    }
}

Response parameters

In the response, you will find the following parameters:

Property	Type	Description
`Response` → `MetadataOut` → `PaymentCode`	`string`	Payment code generated by PagoEfectivo.
`Response` → `MetadataOut` → `PaymentExpirationDate`	`date`	Date when the CIP will expire. Format ISO 8601.
`Response` → `MetadataOut` → `PaymentUrl`	`string`	URL of the HTML document of the CIP.

PrintScreen

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
    }
}

Last modified January 20, 2025