Version: current

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
Last updated on by Fernando Pankiewicz Gomes