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 :

Name	Type	Description
contact_name*	string(80)	Contact Name
mobile*	string(16)	The whole mobile phone number. Need to add an international area code
email*	string(80)	Email
corporation.registration_name*	string(100)	Registration Name Format:CHARSETS_7
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.line*	string(128)	The first line of the address. Format:CHARSETS_4
corporation.registration_address.line2	string(128)	The second line of the address. Format:CHARSETS_4
corporation.registration_address.postal_code*	string(4-8)	The address zip code, or postal code
corporation.registration_address.city_name*	string(4-80)	The address city Format:CHARSETS_6
corporation.registration_address.state*	string(4-48)	The address state Format:CHARSETS_6
corporation.registration_address.country_code*	string(2)	Country code, refer to CountryCode
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_type*	integer	Director.ID Type
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.line*	string(128)	Director.The first line of the address. Format:CHARSETS_4
person.address.line2	string(128)	Director The second line of the address. Format:CHARSETS_4
person.address.postal_code*	string(4-8)	Director The address zip code, or postal code
person.address.city_name*	string(4-80)	Director.The address city Format:CHARSETS_6
person.address.state*	string(4-48)	Director.The address state Format:CHARSETS_6
person.address.country_code*	string(2)	Director.Country code Refer to CountryCode

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": "[phone]",
        "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

Name	Type	Description
holder_id	long	Corporation Cardholder ID
status	integer	Status : 0-initial 1-enabled 2-disabled

200:OK

{
    "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.

400: invalid-signature

{
    "code": "40002",
    "msg": "Business Failed",
    "sub_code": "invalid-signature",
    "sub_msg": "invalid signature"
}