Your Business Wallets
Your Yativo account comes with one or more currency wallets. Wallets hold your settlement balances and are the source of funds for payouts. You can create additional wallets for different currencies as needed.| Endpoint | Description |
|---|---|
GET /wallet/balance | Returns balances for all your active wallets |
GET /wallet/balance/total | Returns the aggregate balance across all wallets |
POST /wallet/create | Create a new currency wallet |
Customer Virtual Accounts
Virtual accounts are bank accounts assigned to a specific customer. When a third party sends funds to a virtual account number, the deposit is credited to the corresponding customer and avirtual_account.deposit webhook fires.
| Endpoint | Description |
|---|---|
POST /business/virtual-account/create | Issue a virtual account for a customer |
GET /business/virtual-account | List all virtual accounts |
GET /business/virtual-account/show/{id} | Get a single virtual account |
DELETE /business/virtual-account/delete-virtual-account/{id} | Delete a virtual account |
POST /business/virtual-account/history/{account_number} | Get transaction history for an account |
Wallet vs. Virtual Account
| Wallet | Virtual Account | |
|---|---|---|
| Owner | Your business | An end customer |
| Purpose | Hold settlement balances, fund payouts | Receive deposits on behalf of a customer |
| Currency | USD, EUR, and others | Local currency (BRL, CLP, MXN, etc.) |
| Created by | Dashboard or POST /wallet/create | POST /business/virtual-account/create |
| Funded by | Payins, topped up | Customer or third party sending to account number |
Supported Currencies
To retrieve all currencies supported by the platform:Next Steps
- Wallets — manage your business wallet balances and payouts
- Virtual Accounts — issue accounts to customers for receiving deposits
- Deposits — track and process incoming payments