π΅πͺ Peru Local Acquiring
Payment Method Properties
Markets | PE |
Brands | DINERS , DISCOVER , MASTER , VISA |
Processing currencies | PEN |
Consumer currencies | PEN |
Settlement currencies | PEN , EUR , GBP , HKD , SGD , USD |
Minimum payment amount | 0.00 PEN |
Maximum payment amount | Varies by card issuer |
Recurring payments | Yes |
Separate captures | Yes |
Instalments | No |
Zero value authorizations | Yes |
Refund | Full - Partial - Multiple Partial |
Refund validity | 365 days |
Authorization reversal | Yes |
Authorization validity | 7 days |
EMV 3-D Secure | No |
Chargeback | Yes |
Sandbox Availability | PPRO provided |
One-time Payment
1. Create a payment charge
In your /v1/payment-charges
request, include:
paymentMethod
: CARD
instrument.type
: RAW_CARD
Request:
{
"paymentMethod": "CARD",
"paymentDescriptor": "Acme Inc. - Order 123",
"amount": {
"value": 4000,
"currency": "PEN"
},
"consumer": {
"billingAddress": {},
"country": "PE",
"name": "John Smith"
},
"instrument": {
"type": "RAW_CARD",
"details": {
"brand": "VISA",
"number": "4111111111111111",
"cvv": "123",
"holderName": "John Smith",
"expiryMonth": 1,
"expiryYear": 2026
}
}
}
Response:
{
"id": "charge_JqOxPe5C0ltzDym2Wb4zo",
"paymentMethod": "CARD",
"currency": "PEN",
"country": "PE",
"paymentDescriptor": "Acme Inc. - Order 123",
"status": "CAPTURE_PENDING",
"consumer": {
"name": "John Smith",
"country": "PE",
"billingAddress": {}
},
"authorizations": [
{
"id": "authz_GRlW0pINO5ftY8aLTVtbg",
"amount": 4000,
"status": "AUTHORIZED",
"createdAt": "2023-07-06T15:17:19.141Z",
"updatedAt": "2023-07-06T15:17:19.141Z"
}
],
"captures": [],
"refunds": [],
"voids": [],
"createdAt": "2023-07-06T15:17:19.043Z",
"updatedAt": "2023-07-06T15:17:19.140Z",
"_links": {
"authorizations": {
"href": "/v1/payment-charges/charge_JqOxPe5C0ltzDym2Wb4zo/authorizations"
},
"captures": {
"href": "/v1/payment-charges/charge_JqOxPe5C0ltzDym2Wb4zo/captures"
},
"refunds": {
"href": "/v1/payment-charges/charge_JqOxPe5C0ltzDym2Wb4zo/refunds"
},
"voids": {
"href": "/v1/payment-charges/charge_JqOxPe5C0ltzDym2Wb4zo/voids"
}
}
}
2. Handle the response
- Once the payment has been successfully
AUTHORIZED
you can present the payment outcome to the consumer. - The payment charge status will be in
CAPTURE_PENDING
orCAPTURED
depending ifautoCapture
was applied or not. If required, Capture the payment charge.
Updated 3 months ago