Version: current

UX Recommendations for Peru

About this guide

This page will present some resources to help you to provide a better user experience for your customers in Peru. The content is divided into three main sections, covering mandatory fields translations, field validation and checkout live suggestions.

If you are looking for an integration guide with mandatory parameters and examples, you can find it here:

Mandatory fields

Below you will find all the mandatory fields, as well the translations for both fields and placeholder texts.

Personal information

FieldTranslationPlaceholder
E-mailCorreo electrónico
Full nameNombre y Apellido
Phone numberTeléfonoFijo o Celular
DocumentN√ļmero del Documento

Credit card fields

In the table below you can find the suggesed translations based in local e-commerce best practices.

FieldTranslation
Cardholder nameNombre del titular
Card numberN√ļmero de la tarjeta
Expiration dateFecha de expiración
CVVCódigo de seguridad (CVV)
InstallmentsCuotas

Billing address information

These fields are needed for credit card transactions only.

FieldTranslationPlaceholder
ZipcodeCódigo postal
CountryPaísSelecciona tu País
StateDepartamentoSeleccione tu departamento
CityCiudad
AddressDirección
Street NumberN√ļmero

Validation

Below you will find how to validate each mandatory field, preventing user errors and guaranteeing a correct payment processing in Peru.

Personal information

Field name and parameterValidationsError messages
Email
payment.email
REGEX: ^[a-zA-Z0-9.!#$%&'*+/=?^_{\|}~-]+@[a-zA-Z0-9]\(?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?(?:\.[a-zA-Z0-9]\(?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$Empty field:
Este campo es requerido

Invalid format:
Este correo electrónico parece estar incorrecto
Phone Number
payment.phone_number
10 digits
Mask: MM-XXXX-XXXX
Empty field:
Este campo es requerido

Invalid format:
Este teléfono parece estar incorrecto
Document
payment.document
DNI: Length of 8, 9 or 11 digits. 10 digit inputs are not valid.Empty field:
Este campo es requerido

Invalid format:
Este documento parece estar incorrecto

Credit card information

Field name and parameterValidationsError messages
Credit card number
payment.creditcard.card_number
Masks:
  - AMEX: 9999 9999 9999 99999
  - Other Brands: 9999 9999 9999 9999

Regular Expression:
https://developers.ebanx.com/api-reference/ebanx-payment-api/payment-reference/validation-rules
Empty field:
Este campo es requerido

Invalid format:
Esta tarjeta parece estar incorrecta
Expiration Date
payment.creditcard.card_due_date
Mask: XX/XXXX
REGEX: ^(0[1-9]|1[0-2])\/([0-9]{4})$
Empty field:
Este campo es requerido

Invalid format:
Esta fecha parece estar incorrecta
CVV
payment.creditcard.card_cvv
AMEX: 4 digits, numeric only
Other Brands: 3 digits, numeric only
Empty field:
Este campo es requerido

Invalid format:
El código parece estar incompleto

Billing address information

Field name and parameterValidationsError messages
Zip Code
payment.zipcode
5 digits, numeric onlyEmpty field:
Este campo es requerido

Invalid format:
Este código postal parece estar incorrecto
State
payment.state
Amazonas
Ancash
Apurímac
Arequipa
Ayacucho
Cajamarca
Callao
Cusco
Huancavelica
Hu√°nuco
Ica
Junín
La Libertad
Lambayeque
Lima (Provincia)
Lima
Loreto
Madre de Dios
Moquegua
Pasco
Piura
Puno
San Martín
Tacna
Tumbes
Ucayali
Empty field:
Este campo es requerido

Invalid format:
Este estado parece estar incorrecto

Validation snippets

You can use the following Javascript funcions to validate some of the mandatory fields requested in your checkout.

zipcode_validation.js
function validateZipcode(zipcode){
const re = /[0-9]{5}/;
return re.test(String(zipcode));
}

Checkout recommendations

Below you will find live code examples, where you can view and test the checkout experience in this country. Also, you will find recommendations to offer a better experience for your customers.

Personal information

Preview
Datos del comprador
Todas las informaciones abajo son requeridas.

Live code editor
Instructions
  • These fields are required for any payment method in Peru;
  • If the customer provided this information in previous steps, you can reuse it to reduce friction.

Card information

Preview
Datos de la tarjeta
Todas las informaciones abajo son requeridas.

¬ŅEn cu√°ntas cuotas deseas pagar?


Datos del titular de la tarjeta
Todas las informaciones abajo son requeridas, excepto "Complemento"

Opcional

Live code editor
Instructions
  • Offer a tooltip explaining CVV: "C√≥digo de 3 n√ļmeros situado en el reverso de la tarjeta. En las tarjetas AMEX, el c√≥digo es de 4 n√ļmeros se sit√ļa en la frente de la tarjeta"
  • Installments are only available for Credit Card payments

Payment method selection

Payment method selection

Instructions
  • Present all payment methods clearly
  • Load the list of payment methods with the first option already selected by default
  • Make the selector, being it a card or a radio list, to look clickable
  • You can use icons to make each payment method more recognizable

Credit card selection

Credit card

Instructions
  • Use terminologies that are familiar to the user (check Mandatory Fields above)
  • You can use a clear call to action to reinforce the method selection
  • If using Installments (Cuotas), it can be interesting to show it together with the total amount (Check Total Order Amount)

PagoEfectivo selection

PagoEfectivo

Instructions
  • You can offer a short explanation when the payment method is selected.
  • You can use a clear call to action to reinforce the method selection.

PSE - Pagos Seguros en Línea selection (SafetyPay)

OnlineCash
SafetypaySafetypay
Instructions
  • You can offer a short explanation when the payment method is selected.
  • You can use a clear call to action to reinforce the method selection.

Total order amount

RegularFree shipping
Total amount description - RegularTotal amount description - Free shipping
Instructions
  • Always show values clearly, such as shipping taxes and installment number, preventing surprises.
  • When dealing with different currencies, pay attention to how you present the difference between then. Also, if possible present exchange rate ("Tipo de Cambio") to the customer.
Last updated on by Leo Goulart