Version: current

UX Recommendations for Uruguay

About this guide

This page will present some resources to help you to provide a better user experience for your customers in Uruguay. 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
DocumentCédula de Identidad

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
StateDepartamentoSelecciona tu Departamento
CityCiudad/Barrio
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 Uruguay.

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
8 digits, numeric only.
Mask: 9999-9999
Empty field:
Este campo es requerido

Invalid format:
Este teléfono parece estar incorrecto
Document
payment.document
Length of 8 or 9, numeric only.
Mask: 9.999.999-99 or 99.999.999-9
REGEX: [0-9]{9}
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
Artigas
Canelones
Cerro Largo
Colonia
Durazno
Flores
Florida
Lavalleja
Maldonado
Montevideo
Paysand√ļ
Río Negro
Rivera
Rocha
Salto
San José
Soriano
Tacuarembó
Treinta y Tres
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 Uruguay;
  • 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)

Debit 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
  • Be careful to not show installment (Cuotas) options here, since they are only available for credit card payments

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