Skip to main content

Data Validation

Below are the validation rules applied to input fields.

Credit Cards​


Credit Card Scheme​

The credit card scheme payment.payment_type_code can be identified using the following regular expressions. Please note that for a brand to be accepted, both the "include" and "exclude" conditions must be true. Additionally, these rules must be verified in the order they are listed 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​

FieldDescription
Taxpayer ID (CPF)
payment.document		EBANX.js Document Check
State
payment.state		EBANX.js State List
Zip Code
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​

FieldDescription
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​

FieldDescription
Taxpayer ID
payment.document		EBANX.js Document Check

Still need help?

Help Image

We hope this article was helpful. If you still have questions, you can explore the following options: