Skip to main content
Ensure correct input from customers to increase conversion It is mandatory to ensure the following validations for the billing address for customers in United States of America (US) and Canada (CA). This is applicable to:
  1. /v3/checkout
  2. /v3/escrow
  3. /v3/payin
  4. confirmPayment() (Javascript SDK)

​
Validations

FieldValidationApplicable for countries
billing_details.address.countryISO 3166-1 alpha-2 country code (in uppercase)US, CA
billing_details.address.line1Min 4 characters, only alphanumeric characters allowedUS, CA
billing_details.address.cityOnly alphanumeric characters allowedUS, CA
billing_details.address.stateOnly alphanumeric characters allowedUS, CA
billing_details.address.state2-letter State/Province code (ISO 3166-2). The state names and code can be accessed from this list for US and this list for CAUS, CA
billing_details.address.postal_codeFor US, valid length is 5 or 9 and the format is NNNNN. For CA, valid length is 6 and the format is ANA NAN (A = Alphabet, N = Number)US, CA
billing_details.phone.calling_codeOnly codes from this listUS, CA
billing_details.phone.numberOnly numeric values allowed. Length allowed: USA: 10, Canada: 10US, CA