Skip to content

KYC Reliance Customer Registration

Request

Allows you to register customer details with Banxa before an Order is created. This reduces the need for customers to re-submit personal details and perform KYC during the Banxa checkout flow. Detailed guide on how to implement this API can be found here.

This endpoint is restricted and subject to Banxa approval.

Security
sec0
Bodyapplication/json
account_referencestringrequired

Unique customer reference provided by you. This should be the same value that is passed when calling the calling the Create Order endpoint.

Default:"test001001"
emailstringrequired

Customer's email address. Must be a valid email address, and the Customer must have access to this email address to perform OTP verification if required.

mobile_numberstring

Customer's contact number. Must be a valid mobile number and can support a value with or without "+" in the input.

Default:"+16102458680"
given_namestringrequired

Customer's given / first name.

Default:"Joe"
middle_namestring

Customer's second / middle name/s

Default:"Winter"
surnamestringrequired

Customer's surname / last name.

Default:"Bloggs"
dobstringrequired

Customer's date of birth (e.g. "1985-01-31"). Required to format as ISO 8601 Date format : YYYY-MM-DD.

Default:"1990-01-31"
address_line_1stringrequired

Customer's residential address: Street number, street name and street type/suffix. E.g. "2 Abbey Road".

Default:"1 East Liberty Street"
suburbstringrequired

Address city or suburb.

Default:"Reno"
post_codestringrequired

Address postal / PIN / ZIP code.

Default:"89501"
statestringrequired

Address state / region. The 2-letter abbreviation for US States must be used.

Default:"NV"
countrystringrequired

Customer's country of residence. Required to be formatted using ISO 3166 two-letter country code e.g. "US" or "AU".

Default:"US"
document_typestringrequired

Supported values are PASSPORT , DRIVING_LICENSE or IDENTIFICATION,

Default:"PASSPORT"
document_numberstringrequired

The unique identity document number. For example a Passport number.

Default:"530000000"
ssnstring

Customer's Social Security Number. Required if the Customer's Country of Residence is United States (e.g. the 'country' parameter contains a value of "US"). Must be submitted in the following format: "XXX-XX-XXXX".

Default:"530-42-3010"
screening_datestring

The most recent date on which a PEP & Sanction screening check was conducted for the Customer. Required to format as ISO 8601 Date format : YYYY-MM-DD , date must be today or before.

Default:"2022-05-01"
screening_sanctions_resultboolean

If the Sanctions screening scan revealed the Customer is Sanctioned, then return a value of TRUE, otherwise return a value of FALSE.

Default:false
screening_pep_resultboolean

If the PEP screening scan revealed the Customer is a PEP, then return a value of TRUE otherwise return a value of FALSE.

Default:false
curl -i -X POST \
  https://docs.banxa.com/_mock/products/legacy-api/openapi/api/identities/reliance \
  -H 'Authorization: YOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_reference": "test001001",
    "email": "[email protected]",
    "mobile_number": "+16102458680",
    "given_name": "Joe",
    "middle_name": "Winter",
    "surname": "Bloggs",
    "dob": "1990-01-31",
    "address_line_1": "1 East Liberty Street",
    "suburb": "Reno",
    "post_code": "89501",
    "state": "NV",
    "country": "US",
    "document_type": "PASSPORT",
    "document_number": "530000000",
    "ssn": "530-42-3010",
    "screening_date": "2022-05-01",
    "screening_sanctions_result": false,
    "screening_pep_result": false
  }'

Responses

200

Bodyapplication/json
dataobject
Response
{ "data": { "account": {} } }