Create Account

This API is used to create a account. If successful, a new card will be automatically applied for after kyc approved.

• Path: /api/v1/account/create

• Method: POST

• Content-Type

  application/json

• Headers

Key	Type	Required	Comments
authorization	string	YES	Authorization Header

• Body

Key	Type	Required	Comments
api_key	string	YES	api key
request_id	string	YES	Unique id; the shortest is 20 characters, the longest is 64 characters
timestamp	string	YES	13-digit; Valid for plus or minus 30 seconds
card_type	number	YES	Card Type; 1:VISA 2:Mastercard 3:UnionPay
card_level	number	YES	Card Level; 1: Premier； 2: Prestige
first_name	string	YES	First name of the account. Max character length can be 12. Alphabets and spaces only
middle_name	string	Optional	Account's middle name. Max character length can be 12. Alphabets and spaces only
last_name	string	YES	Last name of the account. Max character length can be 12. Alphabets and spaces only
username	string	YES	Unique username of the account. Max character length can be 10, alphabets and number only
title	string	YES	Mr、 Mrs、 Ms
email	string	YES	Email address of the account. Must be unique.
mobile_number	string	YES	Account's mobile number. Max 15 digits allowed. Must be Unique.
gender	string	YES	Male、Female
card_holder_name	string	YES	Name of the account displayed on the card. Max 23 characters. Alphanumeric and spaces only;
country_code	string	YES	2 digit ISO country code where the account resides.
country	string	YES	Country where the account resides.
date_of_birth	string	YES	Minimum age is 18; Date Format: YYYY-MM-DD
calling_code	string	YES	Mobile number prefix.Do not use "+".Ex:1 for US、 91 for IN
calling_country_code	string	YES	2 digit ISO country code. Must coinside with callingCode.
state	string	YES	Account's address state.
city	string	YES	Account's address city.
postal_code	string	YES	City postal code.
address	string	YES	Account's residence address. Alphabets and number #.-()/,Only
secondary_address	string	Optional	Second line address of the account. Alphabets and number #.-()/,Only
is_same_address	Bool	YES	Is the mailing address information same as the address information；
mail_address	string	Optional	Account's mailing address. Required if is_same_address is false
mail_secondary_address	string	Optional	Second line mailing address of the account.
mail_city	string	Optional	mailing city. Required if is_same_address is false
mail_state	string	Optional	mailing state. Required if is_same_address is false
mail_country	string	Optional	mailing country. Required if is_same_address is false
mail_postal_code	string	Optional	mailing postal code. Required if is_same_address is false
sign	string	YES	sign: MD5(api_key+username+timestamp+secret+request_id)lowercase hex

• Example

  {
    api_key: 'fd01a53d7834b06c080cd1024ae9c60a',
    request_id: '5737eb4809b846e48ad15d4b8f97d98c',
    timestamp: '1682072257009',
    card_type: 1,
    card_level: 1,
    first_name: 'lili',
    middle_name: 'lili',
    last_name: 'lili',
    username: 'lili1',
    title: 'Mrs',
    email: '[email protected]',
    mobile_number: '123456',
    gender: 'Male',
    card_holder_name: 'lili',
    country_code: 'CN',
    country: 'China',
    date_of_birth: '2012-10-10',
    calling_code: '86',
    calling_country_code: 'CN',
    state: 'aaa',
    city: 'aaa',
    postal_code: '10010',
    address: 'aaa',
    secondary_address: 'aaa',
    mail_address: 'aaa',
    mail_secondary_address: 'aaa',
    mail_city: 'aaa',
    mail_state: 'aaa',
    mail_country: 'aaa',
    mail_postal_code: 'aaa',
    sign: '6f411a001e7a15802acc4a8d6b2d51e5'
  }

  signature example:MD5(fd01a53d7834b06c080cd1024ae9c60alili1168207225700916388ce4331b35e8e0d32777ba57d7d95737eb4809b846e48ad15d4b8f97d98c)

• Response

Key	Type	Comments
code	number	Response code
msg	string	Response message
data	object	details

details

Key	Type	Comments
card_id	string	Card unique id

• Example

  {
    "code": 10200,
    "msg": "ok",
    "data": {
      "card_id": "39e900293a754851ae204f008235eaa5"
    }
  }