Data Validation Rules | EBANX Developers Academy | EBANX Developers Academy (2024)

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#

For payments in Mexico#

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