Create account

POST

/v1/core/accounts

Last modified:2025-09-07 17:38:45

Maintainer:Not configured

Create ledger account.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

Authorization: Bearer ********************

Token URL: https://auth.nova.bb/oauth2/token

Scopes:

core:write-Write core banking resources.

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢201Created

application/json

Success

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠409409

🟠422Parameter Error

🟠429429

🔴500Server Error

🔴503Service Unavailable

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1/core/accounts' \
--header 'X-Request-Id;' \
--header 'Idempotency-Key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "owner_type": "customer",
    "owner_id": "cus_001",
    "product_code": "WALLET_MAIN",
    "currency": "BBD"
}'

Response Example

201 - Success

{
    "id": "acc_7QfH",
    "owner_type": "customer",
    "owner_id": "cus_001",
    "product_code": "WALLET_MAIN",
    "status": "active",
    "currency": "BBD",
    "created_at": "2025-09-07T09:00:00Z"
}

Modified at 2025-09-07 17:38:45

Customer & Merchant Scope

Get account