DocumentationAPI Reference
Documentation

Country Data

The following is the latest information from Reach regarding the data requirements per country. There are only strict requirements in a subset of countries. In general, for countries other than those listed below, please refer to the address formatting information from the Universal Postal Union for general formatting information.

AR: Argentina

Consumer Information

All local orders in Argentina must include the DNI, or "Documento Nacional de Identidad" in the "NationalIdentifier" field.

Format: Numeric value between 7 and 11 digits

BR: Brazil

EFT

The shopper's bank must be specified in the Issuer field of the checkout API call. The list of acceptable banks is returned from getPaymentMethods.

Consumer Information

All local orders in Brazil must include the CPF as the "NationalIdentifier" field if the purchase is by a person, or the CPNJ as the "NationalIdentifier" field if the purchase is by a company. The "BirthDate" of the consumer is also required.

Brazilian addresses must include a ZIP code and use the abbreviation code for the state below:

CodeNameCodeName
ACAcrePBParaíba
ALAlagoasPRParaná
APAmapáPEPernambuco
AMAmazonasPIPiauí
BABahiaRJRio de Janeiro
CECearáRNRio Grande do Norte
DFDistrito FederalRSRio Grande do Sul
ESEspirito SantoRORondônia
GOGoiásRRRoraima
MAMaranhãoSCSanta Catarina
MTMato GrossoSPSão Paulo
MSMato Grosso do SulSESergipe
MGMinas GeraisTOTocantins
PAPará

CA: Canada

Consumer Information

Canadian addresses must include a postal code, and use the abbreviation code for the province/territory below:

CodeNameCodeName
ABAlbertaNUNunavut
BCBritish ColumbiaONOntario
MBManitobaPEPrince Edward Island
NBNew BrunswickQCQuebec
NLNewfoundland and LabradorSKSaskatchewan
NSNova ScotiaYTYukon
NTNorthwest Territories

CL: Chile

EFT

The shopper's bank must be specified in the Issuer field of the checkout API call. The list of acceptable banks is returned from getPaymentMethods.

Format: Alphanumeric value between 8 and 9 digits

IN: India

All local orders in India must include the PAN number in the "NationalIdentifier" field in this format "[PAN]".

For example: "NationalIdentifier":"ARLPA0061H"

👍

The PAN is a 10 character string where the first 5 characters are letters, the next four are digits, and the last character is a letter.

Credit Cards

3D Secure is required for credit cards processed locally in India. Contact our technical team for assistance. Find out more information about 3DS here.

If a customer enters a local card, Reach will pass back the 3Ds information the merchant needs to use to redirect the customer to for authentication. If it’s not a local card, no 3Ds link will be passed and the transaction will be processed without 3Ds.

Testing

For testing local India credit cards with 3DS in sandbox, the cardholder name needs to be specified as “PEND” to trigger the 3DS interaction.

MX: Mexico

All local non-Card orders in Mexico must include the customer's RFC number in the "NationalIdentifier" field.

Bank Transfers

In Mexico, the shopper's bank must be specified in the Issuer field of the checkout API call. The list of acceptable banks is returned from getPaymentMethods.

Credit Cards

Due to acquiring channel limitations, credit card pre-authorization in Mexico requires special consideration. Contact our technical team for assistance.

Debit Cards

Debit cards in Mexico are supported using the DEBIT payment method, which does not support pre-authorization.

Consumer Information

Mexican addresses must include a ZIP code, and use the abbreviation code for the state below:

CodeNameCodeName
AGSAguascalientesMORMorelos
BCBaja CaliforniaNAYNayarit
BCSBaja California SurNLNuevo Leon
CAMCampecheOAXOaxaca
COACoahuilaPEUPuebla
COLColimaQROQueretaro
CHSChiapasROOQuintana Roo
CHIChihuahuaSLPSan Luis Potosi
DFDistrito FederalSINSinaloa
DGODurangoSONSonora
GTOGuanajuatoTABTabasco
GROGuerreroTAMTamaulipas
HGOHidalgoTLATlaxcala
JALJaliscoVERVeracruz
MEXMexicoYUCYucatan
MICMichoacanZACZacatecas

NL: Netherlands

iDEAL

The shopper's bank must be specified in the Issuer field of the checkout API call. The list of acceptable banks is returned from getPaymentMethods.

PE: Peru

EFT

The shopper's bank must be specified in the Issuer field of the checkout API call. The list of acceptable banks is returned from getPaymentMethods.

SE: Sweden

Debit payment methods must be prioritized and displayed before credit or pay later payment methods. Credit options must not be pre-selected or pre-filled.

For more information on this requirement, please see the Swedish government regulation.

This requirement is applicable for the following situations.

  • Your business processes in SEK.
  • Your business maintains a Swedish entity.
  • Your business maintains a .se or .nu domain
  • Your business actively markets to Swedish consumers.
  • You have over 1000 Swedish shoppers a month as measured from IP, issuer, or shipping address.

US: United States

Consumer Information

US addresses must include a ZIP code (+4 optional), and use the abbreviation code for the state/territory below:

CodeNameCodeName
ALAlabamaNMNew Mexico
AKAlaskaNYNew York
AZArizonaNCNorth Carolina
ARArkansasNDNorth Dakota
CACaliforniaOHOhio
COColoradoOKOklahoma
CTConnecticutOROregon
DEDelawarePAPennsylvania
DCDistrict of ColumbiaRIRhode Island
FLFloridaSCSouth Carolina
GAGeorgiaSDSouth Dakota
HIHawaiiTNTennessee
IDIdahoTXTexas
ILIllinoisUTUtah
INIndianaVTVermont
IAIowaVAVirginia
KSKansasWAWashington
KYKentuckyWVWest Virginia
LALouisianaWIWisconsin
MEMaineWYWyoming
MDMarylandUSUnited States Federal
MAMassachusettsITInternational
MIMichiganPRPuerto Rico
MNMinnesotaVIUS Virgin Islands
MSMississippiMPNorthern Mariana Islands
MOMissouriGUGuam
MTMontanaASAmerican Samoa
NENebraskaPWPalau
NVNevadaAAArmed Forces Americas
NHNew HampshireAEArmed Forces Europe
NJNew JerseyAPArmed Forces Pacific