Create Headless Subaccount
POST/b2b/subaccounts
Create a new headless subaccount in the Payward system.
A headless subaccount is a lightweight account that only requires an external ID mapping, without any user profile data (email, name, phone, etc.).
This is useful for partners who manage user data entirely on their side.
Note: The availability of this endpoint depends on your licensing agreement. Only partners with the relevant licenses in their operating jurisdiction can choose not to share KYC data with Payward.
If you need to create a user with full profile data for KYC verification, use the Create User endpoint instead.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 408
- 409
- 429
- 500
- 503
Subaccount created successfully
Bad Request — the request was malformed or contained invalid parameters. Not retryable.
Unauthorized — authentication failed or credentials are missing/invalid. Not retryable.
Forbidden — the authenticated user does not have permission to perform this action. Not retryable.
Not Found — the requested resource does not exist. Not retryable.
Request Timeout — the request took too long to process. Retryable.
Conflict — the request conflicts with the current state of the resource. Retryable in some cases (see error code).
Too Many Requests — rate limit exceeded. Retryable with backoff.
Internal Server Error — an unexpected error occurred. Generally retryable.
Service Unavailable — the service is temporarily unavailable. Retryable.