🇵🇪 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 or CAPTURED depending if autoCapture was applied or not. If required, Capture the payment charge.