post
https://api.myvendy.com/dedicated-accounts//create
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Creates a bank account number for one of your customers. Transfers into it are credited to your business and reported with wallet events. A successful request returns HTTP 201.
The account name is your business name followed by the customer's name.
Dedicated or omnibus
| You send | You get | Webhook when funded |
|---|---|---|
No destinationWallet | A dedicated account with its own wallet. You can read its history | virtual_account_funded |
destinationWallet set to one of your NGN balance wallets | An omnibus account that pays into that wallet. It has no history of its own | virtual_account_funded |
Before you startGet a provider
slugfrom Available Providers.customerAccountNumberandcustomerBankCodeare the customer's own bank account, which the provider uses to verify them. Get bank codes from List Banks.
Errors
| Code | Message | When |
|---|---|---|
204 | Input is invalid | A required field is missing or malformed. data lists each field |
208 | Data not updated | The provider couldn't create the account. Check the customer details and try again |
221 | Wallet not found | destinationWallet isn't one of your NGN balance wallets |
342 | You do not have permission to take that action | Your keys lack the dedicated-accounts permission |