Submit customer information for Scan-to-Pay

post

https://api-sandbox.interlace.money/open-api/v3/scan2pay/submit-customer-info

Merchant use this API to submit customer identity details (name, phone, ID type, ID number) for compliance validation before initiating a Scan-to-Pay transaction. Returns a unique customerId for subsequent payment association.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

customerEmail

string

required

User's first name. Example: [email protected]

firstName

string

required

User's first name. Example: John

lastName

string

required

User's last name. Example: Smith

dateOfBirth

string

required

Date of birth in YYYY-MM-DD format. Example: 1990-01-01

gender

string

enum

required

User’s gender. Use "M" for male or "F" for female. Example: M

Allowed:

nationality

string

required

Two-letter country code of nationality, as defined in ISO 3166-1 alpha-2. Example: US

nationalId

string

required

ID number. Required for passport/driver’s license/national ID.

idType

string

enum

required

Type of ID.

Allowed:

issueDate

string

required

ID issue date in YYYY-MM-DD format. Example: 2018-05-10

expiryDate

string

required

ID expiry date in YYYY-MM-DD format. Example: 2028-05-10

transactionCountry

string

required

Transaction's country

nationalAddress

object

required

Billing Address

mailAddress

object

Billing Address

idFrontBase64

string

Base64-encoded image of the front side of the ID document. Provide either idFrontBase64 or idFrontId.

idBackBase64

string

Base64-encoded image of the back side of the ID document. Provide either idBackBase64 or idBackId.

idHoldBase64

string

Base64-encoded selfie with the ID document. Provide either idHoldBase64 or idHoldId.

idFrontId

string

File ID of the front side of the ID document, returned by the Scan-to-Pay file upload API. Provide either idFrontId or idFrontBase64.

idBackId

string

File ID of the back side of the ID document, returned by the Scan-to-Pay file upload API. Provide either idBackId or idBackBase64.

idHoldId

string

File ID of the selfie with the ID document, returned by the Scan-to-Pay file upload API. Provide either idHoldId or idHoldBase64.

phoneNumber

string

required

User's phone number without the country code. Example: 13800138000

phoneCountryCode

string

required

The international dialing code of the user's mobile number, numbers only, no "+". Example: 86

Responses

200success

400Bad Request