curl --request POST \
--url https://openplatform.gateapi.io/merchant/open/institution/v1/accounts/create \
--header 'Content-Type: application/json' \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
--data '
{
"request_id": "35778162074976257",
"customer_id": "1234",
"display_name": "my test",
"account_holder": {
"entity_country": "AF",
"entity_type": "BUSINESS",
"entity_name": "My Business Ltd",
"entity_id_type": "BUSINESS_LICENSE",
"entity_id_number": "abcd1234",
"entity_id_expiry": {
"valid_from": 1763538010509
},
"address": {
"line1": "123 Main Street",
"country": "AF"
},
"merchant_category": "GENERAL_RETAIL",
"user_agreement": true
}
}
'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"request_id": "35778162074976257",
"status": "INIT",
"created": "1764139242707",
"display_name": "my test",
"customer_id": "1234",
"account_holder": {
"entity_country": "AF",
"entity_type": "BUSINESS",
"entity_name": "My Business Ltd",
"entity_id_type": "BUSINESS_LICENSE",
"entity_id_number": "abcd1234",
"entity_id_expiry": {
"valid_from": 1763538010509,
"valid_to": null
},
"dob": null,
"business_registration": null,
"address": {
"line1": "123 Main Street",
"country": "AF"
},
"merchant_category": "GENERAL_RETAIL",
"website": null,
"user_agreement": true
},
"metadata": null
}
}Create a new sub-account for a customer under the institution account and register the account holder information.
curl --request POST \
--url https://openplatform.gateapi.io/merchant/open/institution/v1/accounts/create \
--header 'Content-Type: application/json' \
--header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
--header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
--header 'X-GatePay-Signature: <x-gatepay-signature>' \
--header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
--data '
{
"request_id": "35778162074976257",
"customer_id": "1234",
"display_name": "my test",
"account_holder": {
"entity_country": "AF",
"entity_type": "BUSINESS",
"entity_name": "My Business Ltd",
"entity_id_type": "BUSINESS_LICENSE",
"entity_id_number": "abcd1234",
"entity_id_expiry": {
"valid_from": 1763538010509
},
"address": {
"line1": "123 Main Street",
"country": "AF"
},
"merchant_category": "GENERAL_RETAIL",
"user_agreement": true
}
}
'{
"status": "SUCCESS",
"code": "000000",
"errorMessage": "",
"data": {
"request_id": "35778162074976257",
"status": "INIT",
"created": "1764139242707",
"display_name": "my test",
"customer_id": "1234",
"account_holder": {
"entity_country": "AF",
"entity_type": "BUSINESS",
"entity_name": "My Business Ltd",
"entity_id_type": "BUSINESS_LICENSE",
"entity_id_number": "abcd1234",
"entity_id_expiry": {
"valid_from": 1763538010509,
"valid_to": null
},
"dob": null,
"business_registration": null,
"address": {
"line1": "123 Main Street",
"country": "AF"
},
"merchant_category": "GENERAL_RETAIL",
"website": null,
"user_agreement": true
},
"metadata": null
}
}The clientId assigned when the merchant registers an application in the Gate merchant console.
"4186d0c6-6a35-55a9-8dc6-5312769dbff8"
UTC timestamp in milliseconds when the request is generated. GatePay will not process requests where the difference from the receive time exceeds 10 seconds.
"1672905655498"
Random string. Must comply with HTTP header rules; recommended length is within 32 characters, composed of digits and letters.
"9578"
Request signature. GatePay uses this signature to verify whether the request is valid.