Skip to main content
POST
https://api.recital.finance
/
api
/
v1
/
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": "[email protected]",
    "phone": "08011223344",
    "address": "test address",
    "city": "earth",
    "state": "mars",
    "postcode": "test",
    "country": "pluto"
  }
}'

{
  "walletId": "RC_WAL-6DB1M9XQ",
  "accountWalletId": "616b3434-6318-4593-9d29-78302ee19a08",
  "customerEmail": "[email protected]",
  "customerName": null,
  "bankName": "Mock Bank",
  "accountNumber": "0067100155",
  "currency": "NGN",
  "amount": 0,
  "createdAt": null,
  "updatedAt": null
}

​
Authorization

​
Authorization
string
required
API Key
​
walletID
string
Unique identifier for the wallet. Must follow the format RC_WAL-XXXXXX.
​
createVirtualAccount
boolean
Set to true to create a virtual account alongside the wallet.
​
preferredBank
string
If available on provider’s end you can send it here. Mostly available on production.
​
customer.psuId
string
Customer’s unique identifier (e.g., BVN).
​
customer.externalCustomerID
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.
​
customer.psuIdType
string
Type of identifier (BVN, NIN, etc.).
​
customerID
string
Optional; used to enable multi-provider between wallets.
​
customer.name
string
Customer’s full name.
​
customer.email
string
Customer’s email address.
​
customer.phone
string
Customer’s phone number (in international format).
​
customer.address
string
Customer’s street address.
​
customer.city
string
Customer’s city of residence.
​
customer.state
string
Customer’s state of residence.
​
customer.postcode
string
Customer’s postal code.
​
customer.country
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": "[email protected]",
    "phone": "08011223344",
    "address": "test address",
    "city": "earth",
    "state": "mars",
    "postcode": "test",
    "country": "pluto"
  }
}'

{
  "walletId": "RC_WAL-6DB1M9XQ",
  "accountWalletId": "616b3434-6318-4593-9d29-78302ee19a08",
  "customerEmail": "[email protected]",
  "customerName": null,
  "bankName": "Mock Bank",
  "accountNumber": "0067100155",
  "currency": "NGN",
  "amount": 0,
  "createdAt": null,
  "updatedAt": null
}