Wallet

Perhaps the word wallet is familiar to you, for now it's enough to say that you'll be able to carry out transactions by using it. A wallet is capable of keeping the total balance of your transactions.

Use cases

A business can have as many wallets as customers they have on their platform, from which they will manage the balance of customer transactions.

Think of an e-commerce, where each customer registered in the business receives a unique wallet, from which they can receive money to make their purchases.

In addition to this, the business receives a unique and exclusive wallet for its internal management, which we have called the master wallet, with which it can reward its most loyal customers by sending money from it to their customers' wallets.

Consider a customer's wallet, such as a bank account, in which the customer's real-time balance will be stored.

Wallet structure

Field	Description
uuid	Universal unique identifier that Vita Wallet provides for the wallet in all its services.
token	master
balances	Updated balances at current moment
is_master	Boolean field that identifies if wallet is o is not master.

Master wallet

Once access to Vita Business is enabled for a merchant, it is provided with an initial wallet called master wallet, which is intended to be managed by the merchant, from which it can send money to the wallets it deems necessary in its business logic, such as the BONUS policy to reward its best customers. If you want to add balance to this master wallet, you must request it to [e-mail]

If you want to know your master wallet UUID, please use the list wallets endpoint shown on the next page.

SDK

Node

NOTE: create method receives the unique token to create the wallet.

import Business from 'vita-business-node';

try {
    const wallet = await Business.wallets().create(token);
} catch {}