Alternative Payment Methods
Learn how to integrate your solution to process payments with Cash using Pago Express.
Note
We only offer support for merchants in Paraguay through the Gateway model, and we send the invoice to them from Uruguay.
Pago Express
Pago Express is a popular method for paying bills and services in Paraguay, offering convenience and accessibility throughout the country. The customer needs to provide the payment code in a physical branch of Pago Express and complete the payment. Then, Pago Express notifies us, and we report to the merchant.
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 |
|---|---|---|---|
PaymentMediaId | numeric | Yes | The PaymentMediaId for this payment method is 27. |
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 → DocumentTypeId | numeric | No | Customer’s document type. Refer to the Document types table to see the possible values. |
Customer → DocNumber | string | No | Customer’s Document Number. |
Customer → PhoneNumber | string | No | Customer’s phone number. |
Customer → BillingAddress → Country | string | No | Customer’s Country. |
Customer → BillingAddress → State | string | No | Customer’s State. |
Customer → BillingAddress → City | string | No | Customer’s City. |
Customer → BillingAddress → AddressDetail | string | No | Customer’s Address Detail. |
Customer → BillingAddress → PostalCode | string | No | Customer’s Postal Code. |
MetaDataIn → PaymentExpirationInMinutes | numeric | No | Configure the validity of the generated debt using this field, specifying the duration in minutes. The API applies a default value if you don’t provide this information. |
Request example
{
"PaymentMediaId": 27,
"Order": "12345678",
"Amount": 10000,
"TargetCountryISO": "PY",
"MetadataIn": {
"PaymentExpirationInMinutes": "43800"
},
"Currency": "USD",
"Capture": true,
"Customer": {
"FirstName": "Jaime",
"LastName": "Benitez",
"PhoneNumber": "090000001",
"Email": "jbenitez@mail.com",
"DocNumber": "1223334444",
"DocumentTypeId": 2
}
}
Response parameters
In the response, you find the parameter MetadataOut.PaymentCode with the reference number of the generated debt that the customer must present in a Pago Express agency to pay the debt. Furthermore, the parameter MetadataOut.PaymentExpirationDate displays the validity date in ISO 8601 format (YYYY-MM-DDTHH:MM:SS).
Response example
{
"Response": {
"PurchaseId": 1244788,
"Created": "2023-09-13T20:14:54.926",
"TrxToken": null,
"Order": "12345678",
"Transaction": {
"TransactionID": 1263666,
"Created": "2023-09-13T20:14:54.927",
"AuthorizationDate": "",
"TransactionStatusId": 2,
"Status": "Pending",
"ErrorCode": null,
"Description": "0 Transaction registered in PagosWeb",
"ApprovalCode": null,
"Steps": [
{
"Step": "Generic External",
"Created": "2023-09-13T20:14:55.753",
"Status": "Antifraud Approved",
"ResponseCode": null,
"ResponseMessage": null,
"Error": null,
"AuthorizationCode": null,
"UniqueID": null,
"AcquirerResponseDetail": null
},
{
"Step": "CashPaymentGetPWData",
"Created": "2023-09-13T20:14:55.923",
"Status": "PhysicalNetwork GetData",
"ResponseCode": "0",
"ResponseMessage": null,
"Error": "",
"AuthorizationCode": null,
"UniqueID": null,
"AcquirerResponseDetail": null
},
{
"Step": "CashPayment Authorization",
"Created": "2023-09-13T20:14:56.657",
"Status": "PhysicalNetwork Pending",
"ResponseCode": "0",
"ResponseMessage": "Transaction registered in PagosWeb",
"Error": "",
"AuthorizationCode": null,
"UniqueID": null,
"AcquirerResponseDetail": null
}
]
},
"Capture": true,
"Amount": 58233308,
"OriginalAmount": 58233308,
"TaxableAmount": 0,
"Tip": 0,
"Installments": 1,
"Currency": "PYG",
"Description": null,
"Customer": {
"CustomerId": 252569,
"Created": "2023-09-13T20:14:54.270",
"CommerceCustomerId": null,
"Owner": "Anonymous",
"Email": "jbenitez@mail.com",
"Enabled": true,
"ShippingAddress": null,
"BillingAddress": null,
"Plans": null,
"AdditionalData": null,
"PaymentProfiles": [
{
"PaymentProfileId": 257359,
"PaymentMediaId": 27,
"Created": "2023-09-13T20:14:54.463",
"LastUpdate": "2023-09-13T20:14:54.630",
"Brand": "PagoExpress",
"CardOwner": null,
"Bin": null,
"IssuerBank": null,
"Installments": null,
"Type": "PhysicalNetwork",
"IdCommerceToken": 0,
"Token": null,
"Expiration": null,
"Last4": "",
"Enabled": null,
"DocumentNumber": "1223334444",
"DocumentTypeId": 2,
"ExternalValue": null,
"AffinityGroup": null
}
],
"CaptureURL": null,
"UniqueID": null,
"URL": "https://api.stage.bamboopayment.com/Customer/252569",
"FirstName": "Jaime",
"LastName": "Benitez",
"DocNumber": "1223334444",
"DocumentTypeId": 2,
"PhoneNumber": "090000001",
"ExternalValue": null
},
"RefundList": null,
"PlanID": null,
"UniqueID": null,
"AdditionalData": null,
"CustomerUserAgent": null,
"CustomerIP": null,
"URL": "https://api.stage.bamboopayment.com/Purchase/1244788",
"DataUY": {
"IsFinalConsumer": false,
"Invoice": null,
"TaxableAmount": 0
},
"DataDO": {
"Invoice": null,
"Tax": 0
},
"Acquirer": {
"AcquirerID": 53,
"Name": "Pago Express Paraguay",
"CommerceNumber": null
},
"CommerceAction": null,
"PurchasePaymentProfileId": 257359,
"LoyaltyPlan": null,
"DeviceFingerprintId": null,
"MetadataIn": {
"PaymentExpirationInMinutes": "43800"
},
"MetadataOut": {
"PaymentCode": "1244788",
"PaymentMerchantId": "772",
"PaymentExpirationDate": "2023-10-14T03:14:54-03:00"
},
"CrossBorderData": null,
"CrossBorderDataResponse": {
"TargetCountryISO": "PY",
"TargetCurrencyISO": "USD",
"TargetAmount": 100
},
"Redirection": null,
"IsFirstRecurrentPurchase": false,
"AntifraudData": {
"AntifraudFingerprintId": null,
"AntifraudMetadataIn": null
},
"PaymentMediaId": null,
"PurchaseType": 1,
"HasCvv": null,
"TargetCountryISO": null
},
"Errors": []
}
