Create Sub Account

curl --location --request POST 'https://api.recital.finance/api/wallets/account' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <api-key>' \
--data-raw '{
  "walletID": "RC_WAL-3CRWDOWVBO",
  "createVirtualAccount": true,
  "customer": {
    "psuId": "1232345465768",
    "psuIdType": "BVN",
    "name": "Donald Trump",
    "email": "e@x.com",
    "phone": "08011223344",
    "address": "test address",
    "city": "earth",
    "state": "mars",
    "postcode": "test",
    "country": "pluto"
  }
}'

{
  "walletId": "RC_WAL-6DB1M9XQ",
  "accountWalletId": "616b3434-6318-4593-9d29-78302ee19a08",
  "customerEmail": "e@x.com",
  "customerName": null,
  "bankName": "Mock Bank",
  "accountNumber": "0067100155",
  "currency": "NGN",
  "amount": 0,
  "createdAt": null,
  "updatedAt": null
}

{
  "message": "Invalid Wallet ID",
  "success": false
}

POST

api

wallets

account

curl --location --request POST 'https://api.recital.finance/api/wallets/account' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <api-key>' \
--data-raw '{
  "walletID": "RC_WAL-3CRWDOWVBO",
  "createVirtualAccount": true,
  "customer": {
    "psuId": "1232345465768",
    "psuIdType": "BVN",
    "name": "Donald Trump",
    "email": "e@x.com",
    "phone": "08011223344",
    "address": "test address",
    "city": "earth",
    "state": "mars",
    "postcode": "test",
    "country": "pluto"
  }
}'

{
  "walletId": "RC_WAL-6DB1M9XQ",
  "accountWalletId": "616b3434-6318-4593-9d29-78302ee19a08",
  "customerEmail": "e@x.com",
  "customerName": null,
  "bankName": "Mock Bank",
  "accountNumber": "0067100155",
  "currency": "NGN",
  "amount": 0,
  "createdAt": null,
  "updatedAt": null
}

{
  "message": "Invalid Wallet ID",
  "success": false
}

Authorization

string

required

API Key

string

Unique identifier for the wallet. Must follow the format RC_WAL-XXXXXX.

boolean

Set to true to create a virtual account alongside the wallet.

string

If available on provider’s end you can send it here. Mostly available on production.

string

Customer’s unique identifier (e.g., BVN).

string

Optional, this can be used to link an existing customer to a sub-account. This links the customer to their previous transactions; but doesn’t link the transactions to the sub-account yet.

string

Type of identifier (BVN, NIN, etc.).

string

Optional; used to enable multi-provider between wallets.

string

Customer’s full name.

string

Customer’s email address.

string

Customer’s phone number (in international format).

string

Customer’s street address.

string

Customer’s city of residence.

string

Customer’s state of residence.

string

Customer’s postal code.

string

Customer’s country of residence.

curl --location --request POST 'https://api.recital.finance/api/wallets/account' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <api-key>' \
--data-raw '{
  "walletID": "RC_WAL-3CRWDOWVBO",
  "createVirtualAccount": true,
  "customer": {
    "psuId": "1232345465768",
    "psuIdType": "BVN",
    "name": "Donald Trump",
    "email": "e@x.com",
    "phone": "08011223344",
    "address": "test address",
    "city": "earth",
    "state": "mars",
    "postcode": "test",
    "country": "pluto"
  }
}'

{
  "walletId": "RC_WAL-6DB1M9XQ",
  "accountWalletId": "616b3434-6318-4593-9d29-78302ee19a08",
  "customerEmail": "e@x.com",
  "customerName": null,
  "bankName": "Mock Bank",
  "accountNumber": "0067100155",
  "currency": "NGN",
  "amount": 0,
  "createdAt": null,
  "updatedAt": null
}

{
  "message": "Invalid Wallet ID",
  "success": false
}

Wallet API(s)

Transfer API(s)

Misc

Authorization

​Authorization

Authorization