BTSE
Login
Docs
User Service

User Service

Here contains some operations which are related to user.

Get Authorization Information

The endpoint is used to query user authorization information via providing merchantUserId.

QUERY PARAMETERS
merchantUserId
required
string
Example: merchantUserId=75bdd771-41d1-4316-8ddb-041001c8add2
Merchant User ID
HEADER PARAMETERS
api
required
string
The API Key we provide you
nonce
required
string
Current timestamp in millisecond
sign
required
string
The signature you sign

Responses

Cancel Authorization

The endpoint is used to trigger the process of canceling authorization of one user. The user must authorized permission to you before. If the userKey in request body didn't link with your merchant account, the request would be denied.

Please notice that once users cancel authorization, those userKeys can no longer be used.

HEADER PARAMETERS
api
required
string
The API Key we provide you
nonce
required
string
Current timestamp in millisecond
sign
required
string
The signature you sign
REQUEST BODY SCHEMA:application/json
merchantUserId
required
string
Merchant User ID
userKey
required
string
User identification key

Responses

Upload User KYC Files

Upload KYC files by MerchantUserId. If you used same merchantUserId to upload different files, old files would be replaced with new files under same merchantUserId.

Please notice that there are restrictions on files uploaded:

  • Accepted file type: jpg, jpeg, png, pdf
  • Max size: 5 MB per files, 10 MB in total

The way of signature calculation is different from others. Please refer to Introduction -> How to Prepare Signature -> Content-Type: multipart/form-data.

HEADER PARAMETERS
api
required
string
The API Key we provide you
nonce
required
string
Current timestamp in millisecond
sign
required
string
The signature you sign
REQUEST BODY SCHEMA:
email
required
string
User Email
firstName
required
string
First Name
idNumber
required
string
ID Number
idType
required
string
ID Type(1: ID Card, 7: Passport, 8: Driver License)
lastName
required
string
Last Name
merchantUserId
required
string
Merchant User ID
nationality
required
string
Nationality of User and it should be in Country Alpha-3 Code
idFileFront
required
string
ID File (Front)
idFileBack
required
string
ID File (Back). The file is required when idType is 1(ID Card) or 8(Driver License)
selfie
required
string
Selfie with ID Card.

Responses