CREATE ACCOUNT

Validation rules

This page's content:

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

Credit Cards

Credit card scheme payment.payment_type_code

The credit card scheme 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 above.

  • American Express:
    • Includes: ^((34)|(37))
    • Excludes: ^((384100)|(384140)|(384160))
  • Diners:
    • Includes: ^(36)
  • Mastercard:
    • Includes: ^(5|(2(221|222|223|224|225|226|227|228|229|23|24|25|26|27|28|29|3|4|5|6|70|71|720)))
    • Excludes: ^((50670[7-8])|(506715)|(50671[7-9])|(50672[0-1])|(50672[4-9])|(50673[0-3])|(506739)|(50674[0-8])|(50675[0-3])|(50677[4-8])|(50900[0-9])|(50901[3-9])|(50902[0-9])|(50903[1-5])|(50903[8-9])|(50904[0-9])|(50905[0-9])|(50906[0-4])|(50906[6-9])|(50907[0-2])|(50907[4-5])|(504175)|(50907[6-9])|(50908[0-9])|(530032)|(522499)|(509[0-7][0-9]{2})|(509[8]0[0-9])|509810)
  • Elo:
    • 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[12359]|7[02-9]|8[0-47]|9[479])|3(0[0-79]|1[1-49]|2[039]|3[02-79]|4[0-49]|5[0-79]|6[014-79]|7[0-49]|8[023467]|9[124])|402)|606333|636379|639(388|484|559)|588772(02|66|67|68|74|84)|6046220[34])
Credit card number payment.creditcard.card_number

Luhn algorithm

Credit card cardholder name payment.creditcard.card_name

Length between 2 and 26 digits

Credit card due date payment.creditcard.card_due_date

Date in the format MM/YYYY (e.g., 10/2019)

Credit card security code (CVV) payment.creditcard.card_cvv

The length between three and four digits.

Customer data

For payments in Brazil

Taxpayer ID (CPF) payment.document

CPF validation algorithm

Birth date payment.birth_date

Date in the format DD/MM/YYYY (e.g., 01/02/1983)

State payment.state

ISO-3166-2 Alpha-2 code

Zipcode payment.document

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. You can see below an example of complete phone number for both Brazil and Mexico:

  • Brazil

country code (+55)

area code (XX)

phone/mobile (XXXX-XXXX / XXXXX-XXXX)

Example: +55 41 3140-8723 or 99872-1281

  • Mexico

country code (+52)

area code (XX / XXX)

phone/mobile (XXXX-XXXX / XXX-XXXX)

Example: +52 040 577-7687

First Steps

Integration Methods

Sandbox Testing