StatusSupportGet API keys
Auth flow

Create subaccount

POST/v1/account/subaccount

Creates a subaccount linked to the authenticated main account. The subaccount receives its own userId and can operate independently within the scope granted by the main account.

Authorization

ApiKeyAuth
X-Api-Key<token>

For accessing these endpoints a valid API key must be sent in the X-Api-Key header.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

Create subaccount
curl --request POST \  --url 'https://gateway.bit2me.com/v1/account/subaccount' \  --header 'Content-Type: application/json' \  --data '{  "email": "junior@example.com",  "name": "Alex",  "phone": {    "countryCode": "34",    "number": "612345678"  },  "surname": "Smith",  "type": "person"}'
{  "userId": "550e8400-e29b-41d4-a716-446655440099"}

Social Pay vs pocket transfer

Two different rails. Do not treat Social Pay as silent institutional treasury.

Sign in with API key POST

Authenticates a user using an API key and returns a JWT access token. The API key must be sent via the `ApiKeyAuth` security scheme. The request body carries the `userId` that the key belongs to. On success the response contains an `accessToken` with its expiration timestamp.