Our API Docs just got a new look!

🇵🇪Peru

Country specifications

country code
currency code
amount decimals
document name
document format
document required?

PE

PEN and USD

2

CE and CPP

Numeric. Length 9.

Yes

Card features

Card-on-file
Subscriptions
3DS
Installments
Authorization and Capture

Brands available

payment_method code CC

Logo
payment_method
Name

VI

Visa

VD

Visa Debit ​

MC

Mastercard

MD

Mastercard Debit ​

AE

American Express

DC

Diners Club


Alternative Payment Methods available

Logo
payment_method
Name
payment_type
Flows

XA

Tupay

VOUCHER

EmbbededRedirect

XAQR

Tupay QR

VOUCHER

EmbbededRedirect

XABT

Tupay Bank Transfers

VOUCHER

EmbbededRedirect

XACC

Credit Cards by Tupay

VOUCHER

EmbbededRedirect

EF

Pago Efectivo

VOUCHER

Redirect

YP

Yape

WALLET

EmbbededRedirect

IB

Interbank

BANK_DEPOSIT

Redirect

BC

BCP

BANK_DEPOSIT

EmbbededRedirect

ST

Scotia

BANK_DEPOSIT

Redirect

BAB

Banbif

BANK_DEPOSIT

EmbbededRedirect

RY

Banco Ripley

BANK_DEPOSIT

Redirect

ME

Mercadopago

WALLET

Redirect

NAG

Niubiz Agents Payment

VOUCHER

EmbbededRedirect

RDP

Red Digital

VOUCHER

Redirect

WU

Western Union

VOUCHER

Redirect

BP

BBVA

BANK_DEPOSIT

Redirect

KE

Kasnet

VOUCHER

EmbbededRedirect

TM

Tambo

VOUCHER

Redirect

HC

Caja Huancayo

VOUCHER

Redirect

US

Caja Cusco

VOUCHER

Redirect

JA

Caja Arequipa

VOUCHER

Redirect

JI

Caja ICA

VOUCHER

Redirect

JP

Caja Piura

VOUCHER

Redirect

JT

Caja Tacna

VOUCHER

Redirect

Fields required for the OneShot solution

Payment method name

country

amount

payer[]

payment_method

All

Yes

Yes

Yes

Yes

payer[] object requirements

Payment method name

document

email

first_name

last_name

All

Yes

Yes

Yes

Yes

If any of the required fields are missing the HOSTED flow will be triggered

In that case you will receive the HOSTED value in the checkout_type parameter. You will have to redirect the user to the redirect_url

Tupay methods description

Tupay is peruvian payment solution that allow users to pay with their all their preffered local solutions, within a single checkout.

Merchants can opt to use the payment methods contained within Tupay as standalone by itself, different payment methods include:

Tupay voucher

XA

The payment method Tupay, includes all the payment methods available via this channel, including digital wallets, bank transfers, credit cards, and cash methods. The customer can choose whatever method they want to complete the transaction.

Tupay QR

XAQR

This payment method includes both Yape and Plin, which are the most used digital wallets in Peru, together with other smaller digital wallets. The QR code within can be used to pay with any of these digital wallets.

Tupay Bank Transfers

XABT

Tupay Bank Transfers lets the final customer utilize whatever bank that they have, in order to make a bank transfer as a payment.

Tupay Credit Cards

XACC

This allows customers to pay with a credit card, Visa or MasterCard. Also, it can include debit cards.

Last updated

Was this helpful?