💻
Docs
  • Introduction
  • VIRTUAL CARD
    • Page Integration
      • Quick Page Integration
      • Login-free Page Integration
      • About The Sign
      • Explanation of Return Codes
    • API Integration
      • Things Need To Know
      • About The Sign
      • API For Fetching Usable Card Segments
      • API For Retrieve Enumerations Of The States In The United States
      • API For Creating Virtual Card
      • API For Virtual Card Deposit (recharge)
      • API For Obtaining Card Details
      • API For Updating Virtual Card (update cardholder address)
      • API For Card Refund
      • API For Deleting Card
      • API For Querying Order History
      • Successful card opening callback
      • Fail card opening callback (COPY)
      • Risk Control webhook
      • Error Code
  • Physical card
    • Page Integration
      • Page customization
    • API Integration
      • Create Cardholder
      • Modify Cardholder Information
      • Cardholder Document Upload
      • Cardholder Query
      • Bank Card Application
      • Bank Card Application Result Query
      • Bank Card Activation
      • Bank Card Top-up
      • Bank Card Top-up Order Query
      • Bank Card Query
      • Bank Card Transaction Details Query
      • Bank Card Replacement
      • Bank Card Unloss
      • Bank Card Password Retrieval
      • Bank Card Authorized Transaction Details
      • Partner Account Balance Inquiry
      • Partner Top-up Account Information Inquiry
      • Cardholder Audit Result Notification
      • Bank Card Transaction Notification
  • KYC Sharing API
    • Integration Options
    • Signature Description
    • API
      • Submit basic information
      • Upload photo
      • Submit for approval
      • Query Approval Results
      • Approval Results[Webhook]
Powered by GitBook
On this page
  1. Physical card
  2. API Integration

Create Cardholder

POST Create Cardholder

POST /api/mastercard/holderCreate.html

Create a cardholder. Status: 0 - Pending review, 1 - Under review, 2 - Approved, 3 - Rejected.

Request Body Example

{
  "address": "Laisvés pr. 60",
  "countryCode": "LT",
  "dateOfBirth": "1994-04-10",
  "email": "xxxx@gmail.com",
  "firstName": "JohnA",
  "idno": "ABC12345633",
  "idnoType": 2,
  "lastName": "DoeA",
  "mobile": "+8617601081839",
  "nationality": "US",
  "postCode": "05120",
  "randomStr": "abcdef12345678901",
  "sex": 1,
  "town": "Vilnius"
}

Request Parameters

Name
Type
Required
Base64 Encoded
Field Name
Description

mobile

string

true

none

Mobile Number

Country code + phone number (+861866666)

lastName

string

false

Y

Last Name

Last name

firstName

string

true

Y

First Name

First name

email

string(email)

true

none

Email

Email address

dateOfBirth

string

true

none

Date of Birth

Date of birth (yyyy-MM-dd)

nationality

string

true

none

Nationality

Nationality (two-letter country code)

sex

integer

true

none

Gender

Gender: 1 - Male, 2 - Female

countryCode

string

true

none

European Country Code

Country code (two-letter country code)

town

string

true

Y

European Region

European region or city name (in English)

address

string

true

Y

European Address

European address details (in English)

postCode

string

true

none

Postal Code

Postal code

idnoType

integer

true

none

ID Document Type

ID document type: 1 - European ID card (supported for European nationality only), 2 - Passport

idno

string

true

none

ID Document Number

ID document number

randomStr

string

true

none

Random String

Random string with a length of 32 characters

Response Example

200 Response

{
  "auditStatus": 0,
  "errMsg": "string",
  "firstName": "string",
  "holderId": "string",
  "idno": "string",
  "idnoType": 0,
  "lastName": "string",
  "mobile": "string"
}

Response Parameters

Name
Type
Required
Constraints
Description

auditStatus

integer

true

none

Audit status,0: Pending review, 1: Under review, 2: Approved, 3: Rejected, 4: Data to be completed

errMsg

string

true

none

Description

firstName

string

true

none

First Name

holderId

string

true

none

Cardholder ID

idno

string

true

none

ID Document Number

idnoType

integer

true

none

ID Document Type

lastName

string

true

none

Last Name

mobile

string

true

none

Mobile Number

Last updated 1 year ago