Validation rules

Below you will find the validation rules we use for the input data.

Credit Cards

Credit Card Scheme

The credit card scheme (payment.payment_type_code) can be detected by using the following regular expressions. Note that if the rule has “include” and “exclude”, both need to be true to be accepted as that brand. Also, these rules need to be verified in the order displayed below.

American Express:

• Includes: ^((34)|(37))

Diners:

• Includes: ^((30)|(36)|(38))
• • Excludes: ^((3646)|(3648))

Mastercard:

• Includes: ^(5[1-5][0-9]{2}|222[1-9]|22[3-9][0-9]|2[3-6][0-9]{2}|27[01][0-9]|2720)[0-9]{12}$

• Excludes: ^(514256|514586|526461|511309|514285|501059|557909|501082|589633|501060|501051|501016|589657|553839|525855|553777|553771|551792|528733|549180|528745|517562|511849|557648|546367|501070|601782|508143|501085|501074|501073|501071|501068|501066|589671|589633|588729|501089|501083|501082|501081|501080|501075|501067|501062|501061|501060|501058|501057|501056|501055|501054|501053|501051|501049|501047|501045|501043|501041|501040|501039|501038|501029|501028|501027|501026|501025|501024|501023|501021|501020|501018|501016|501015|589657|589562|501105|557039|542702|544764|550073|528824|522135|522137|562397|566694|566783|568382|569322|504363)

Elo:

^(50(67(1[589]|2[012456789]|3[<wbr />01234569]|4[123567]|53|7[4568]<wbr />)|9(0(0[0137]|2[0-2]|3[59]|4[<wbr />012578]|5[1235789]|6[<wbr />013456789]|7[0134789]|8[047]|<wbr />9[123489])|1(0[0456789]|46)|<wbr />220|407))|6(27780|36368|5(0(0(<wbr />3[12356789]|4[0-9]|5[01789]|6[<wbr />0-9]|7[0-6])|4(0[6-9]|1[0-9]|<wbr />2[0-9]|3[0-9]|8[5-9]|9[0-9])|<wbr />5(0[012346789]|1[0-9]|2[0-9]|<wbr />3[0-8]|5[2-9]|6[0-9]|7[0-9]|8[<wbr />0-9]|9[0-8])|72[0-7]|9(0[1-9]|<wbr />1[0-9]|2[0128]|3[89]|4[6-9]|5[<wbr />0-9]|6[0-9]|7[0-8]))|1(6(5[2-<wbr />9]|6[0-9]|7[0-9]|8[0-9]|9[0-9]<wbr />)|70[0-4])|50(0[0-9]|1[0-9]|2[<wbr />1-9]|3[0-9]|4[0-9]|5[0-7])))|<wbr />65(0(0(4[89]|5[01789]|6[<wbr />013456789]|7[0-6])|4(1[2-9]|2[<wbr />0-9]|3[01238])|5(3[1-8]|5[2-9]<wbr />|6[0-9]|7[0-6]|8[18]|9[4-8])|<wbr />720|9(5[01236789]|6[0129]|7[<wbr />02345678]))|1(6(62|7[0-4]|8[0-<wbr />9]|9[0-9])|70[0-4])|50(05|1[<wbr />189]|2[1-9]|3[0-9]|4[0-9]|5[<wbr />0345])))

• Includes: ^((509091)|(636368)|(636297)|(504175)|(438935)|(40117[8-9])|(45763[1-2])|(457393)|(431274)|(50990[0-2])|(5099[7-9][0-9])|(50996[4-9])|(509[1-8][0-9][0-9])|(5090(0[0-2]|0[4-9]|1[2-9]|[24589][0-9]|3[1-9]|6[0-46-9]|7[0-24-9]))|(5067(0[0-24-8]|1[0-24-9]|2[014-9]|3[0-379]|4[0-9]|5[0-3]|6[0-5]|7[0-8]))|(6504(0[5-9]|1[0-9]|2[0-9]|3[0-9]))|(6504(8[5-9]|9[0-9])|6505(0[0-9]|1[0-9]|2[0-9]|3[0-8]))|(6505(4[1-9]|5[0-9]|6[0-9]|7[0-9]|8[0-9]|9[0-8]))|(6507(0[0-9]|1[0-8]))|(65072[0-7])|(6509(0[1-9]|1[0-9]|20))|(6516(5[2-9]|6[0-9]|7[0-9]))|(6550(0[0-9]|1[0-9]))|(6550(2[1-9]|3[0-9]|4[0-9]|5[0-8])))

Hipercard:

• Includes: ^((606282)|(637095)|(637568)|(637599)|(637609)|(637612))

Visa:

• Includes: ^(4)
• Excludes: ^((451416)|(438935)|(40117[8-9])|(45763[1-2])|(457393)|(431274)|(402934))

CARNET:

• Includes: ^(286900|502275|506(199|2(0[1-6]|1[2-578]|2[289]|3[67]|4[579]|5[01345789]|6[1-79]|7[02-9]|8[0-7]|9[234679])|3(0[0-9]|1[1-479]|2[0239]|3[02-79]|4[0-49]|5[0-79]|6[014-79]|7[0-4679]|8[023467]|9[1234689])|4(0[0-8]|1[0-7]|2[0-46789]|3[0-9]|4[0-69]|5[0-79]|6[0-38]))|588772|604622|606333|627535|636(318|379)|639(388|484|559))

Naranja:

• Includes: ^(589562)

Cabal:

• Includes: ^((627170)|(589657)|(603522)|(604((20[1-9])|(2[1-9][0-9])|(3[0-9]{2})|(400))))
• Excludes: ^(604201|604225|604246)

Cordobesa:

• Includes: ^((542702)|(544764)|(550073)|(528824))

Cencosud

• Includes: ^(603493)

Tarjeta Shopping

• Includes: ^(27995)

CMR

• Includes: ^(557039)

Argencard

• Includes: ^(501105)
• Excludes: ^((589562)|(527571)|(527572))

Mercado Pago

• Includes: ^((515073)|(515070)|(532384))

Credit Card Number

For the card number (payment.creditcard.card_number), use the Luhn Algorithm.

Credit Card Holder Name

The only restriction for card holder name (payment.creditcard.card_name) is the length, which is between 2 and 50 characters.

Credit Card Due date

For the due date (payment.creditcard.card_due_date) use the MM/YYYY format (e.g. 10/2025).

Credit Card Security Code (CVV)

For the CVV, the length is the only restriction. It needs to be between 3 and 4 characters.

Customer Data

For payments in Brazil

Taxpayer ID (CPF) payment.document	EBANX.js Document Check
State payment.state	EBANX.js State List
Zipcode payment.zipcode	Length must be 8 digits; format may be XXXXX-XXX or XXXXXXXX
Phone Number payment.phone_number	Length must be between 8 and 13 digits. country code (+55) area code (XX) phone/mobile (XXXX-XXXX / XXXXX-XXXX) Example: +55 41 3140-8723 or 99872-1281

For payments in Mexico

Phone Number payment.phone_number

Length must be between 8 and 13 digits. country code (+52) area code (XX / XXX) phone/mobile (XXXX-XXXX / XXX-XXXX) Example: +52 040 577-7687

For payments in Argentina, Chile, Colombia, Ecuador, Peru

Taxpayer ID payment.document

EBANX.js Document Check