[B2C Client] Create Subaccount

Request Header

Key ParametersData TypeDescription
publicAccessTokenStringOne time access-token generated using this API
X-SignatureStringA HMAC-SHA512 signature generated using your API secret. This is used to verify the integrity and authenticity of the request. The signature is created based on the request payload and the X-Timestamp.
X-TimestampDateTimeThe timestamp of the request in ISO 8601 format. This is used to validate the freshness of the request. Format: YYYY-MM-DDTHH:MM:SS.SSS±HH:MM
Example: 2025-05-27T10:17:54.964+07:00

Request query parameters

Key ParametersData TypeDescription
nameStringThe name of the business or individual consumer
subAccountCodeStringA unique alphanumeric code (max. 5 characters) used to identify the subaccount
emailStringContact email address for the subaccount
addressStringBusiness or residential address associated with the subaccount
pictureFile(Optional) Logo image file (max. 2 MB) to visually represent the subaccount

Response parameters

Key ParametersData TypeDescription
statusStringStatus of the subaccount creation: "approved" or "rejected"
apiKeyObjectObject containing the generated API credentials
clientKeyStringEncrypted public API key (using Client's public key uploaded via the upload public key API) for the subaccount.
clientSecretStringEncrypted secret key (using Client's public key uploaded via the upload public key API) used to authenticate API requests

Error Response

Please check the B2C Subaccount Onboarding Product Documentation for the error response

Language
Credentials
Click Try It! to start a request and see the response here!