Create Headless Subaccount

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.

POST /b2b/subaccounts

Create Headless Subaccount

cURL

curl --request POST \
  --url https://nexus.kraken.com/b2b/subaccounts \
  --header 'API-Key: <api-key>' \
  --header 'API-Sign: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_id": "partner-user-12345"
}
'

200

{
  "result": {
    "user": "AA95 N84G TEST XXXX"
  }
}

Authorizations

API-Key · string · header · required

The "API-Key" header should contain your API key.

API-Sign · string · header · required

Authenticated requests should be signed with the "API-Sign" header, using a signature generated with your private key, nonce, encoded payload, and URI path.

Headers

Payward-Version · enum<string> · default: 2025-04-15

The target version of the Embed API to use. The API version name is based on the date when the API version was released. For example, the API version 2025-04-15 was released on April 15, 2025.

Available options: 2025-04-15

Body

application/json

external_id · string · required

A unique external user ID for partners to link their user ID to a Payward account. This ID must be unique within your partner account.

Example:

"partner-user-12345"

Response

200

application/json

Subaccount created successfully

result · object

Show child attributes