Create Corporation Cardholder
Endpoint creates a business cardholder entity with card-issuing privileges. Note: Cardholder activation requires KYB verification by our Compliance team.
Request URI
POST
/issuing/holder/create-corporation
Request Body
Refer to : common
Biz_data :
contact_name*
string(80)
Contact Name
mobile*
string(16)
The whole mobile phone number.
Need to add an international area code
email*
string(80)
corporation.registration_code*
string(32)
Registration Code
corporation.registration_date*
string(20)
Registration Date.Format: yyyy-MM-dd
corporation.vat_code
string(32)
VAT Code
corporation.expires_on
string(20)
Expires On.Format: yyyy-MM-dd
corporation.business_scope
string(300)
Business Scope
corporation.registration_address.postal_code*
string(4-8)
The address zip code, or postal code
person.first_name*
string(50)
Director.First Name
person.last_name*
string(50)
Director.Last Name
person.middle_name
string(50)
Director.Middle Name
person.national_name
string(50)
Director.National Name
person.id_no*
string(6-20)
Director.ID Number
person.birthday*
string(20)
Director.Birthday
Format: yyyy-MM-dd
person.issuance_date
string(20)
Director.Issuance Date
Format: yyyy-MM-dd
person.expires_on
string(20)
Director.Expires On
Format: yyyy-MM-dd
person.citizenship_country*
string(2)
Director.Citizenship Country
person.address.postal_code*
string(4-8)
Director
The address zip code, or postal code
Request Example
{
"app_id": "00000000000000000",
"partner_id": "00000000000000000",
"sub_partner_id": "",
"request_id": "CC3B7eD0-6b2d-AbC4-346E-FC8ffA54",
"timestamp": "2025-04-07 13:52:18",
"format": "JSON",
"version": "2.0",
"sign_type": "RSA",
"biz_data": {
"mobile": "+8618102092707",
"email": "[email protected]",
"contact_name": "Test Cjiyzpr",
"corporation": {
"registration_name": "Test User INC",
"registration_code": "360000201510032997",
"registration_date": "2012-12-10",
"vat_code": "vatcode12",
"expires_on": "2032-12-10",
"business_scope": "test records",
"registration_address": {
"city_name": "West Lyda",
"country_code": "MX",
"postal_code": "48162-42",
"state": "Virginia",
"line": "line 1 line 1 line 1 line 1 ",
"line2": "line 2 line 2 line 2 line 2 "
}
},
"person": {
"first_name": "Test",
"last_name": "User",
"citizenship_country": "MX",
"id_type": 2,
"id_no": "360000200812043160",
"gender": 3,
"birthday": "2021-12-09",
"national_name": "rpc",
"issuance_date": "2012-12-10",
"expires_on": "2032-12-10",
"address": {
"city_name": "West Ronaldo",
"country_code": "LR",
"postal_code": "37993",
"state": "Tennessee",
"line": "line 1 line 1 line 1 line 1 ",
"line2": "line 2 line 2 line 2 line 2 "
}
}
},
"random_key": "<generated_key>"
}
// The biz_data in this example needs to be encrypted!
Response
holder_id
long
Corporation Cardholder ID
status
integer
Status : 0-initial 1-enabled 2-disabled
{
"code": "10000",
"msg": "Success",
"total": 1,
"random_key": "<random key used for decryption>",
"sign_type": "RSA",
"app_id": "00000000000000000",
"data": {
"holder_id": 103007,
"status": 1
}
}
// The data in this example has already been decrypted.
Last updated
Was this helpful?