Accounts

Accounts let you and your customers receive payments, store funds, and send transfers. When you create an account, Gravv generates a wallet address and virtual account. You can receive funds into your account with both methods, and all transactions appear in the account balance.

Gravv organizes accounts into two main categories: internal accounts and external accounts.

Internal accounts

Internal accounts are accounts created within Gravv, either through the Create an account endpoint or from the Dashboard. They include main accounts for your business and customer accounts for your customers.

Main accounts

These are accounts associated with your business. You can open multiple main accounts to organize your business operations.

Main accounts include three types:

Regular accounts

Regular accounts handle everyday transactions, including payments, withdrawals, and deposits. They support unlimited transactions but don't earn interest.

Savings accounts

Savings accounts hold funds for longer periods. They earn interest but limit transaction frequency and require a minimum balance.

Card accounts

Card accounts back all virtual cards you issue to customers. Create one card account on your Dashboard before issuing any cards. This one-time setup uses the Polygon blockchain network. The setup supports all customer cards you create.

Customer accounts

These are accounts you create for your customers after onboarding and verifying them using the Know Your Customer (KYC) process. All payments made or received by customers are reflected in their account balances.

Customer accounts can be either regular accounts or savings accounts. Use the Create an account endpoint to create one.

Regular accounts

Regular accounts handle everyday transactions such as payments, withdrawals, and deposits. They allow unlimited transactions but don't earn interest.

Savings accounts

Savings accounts store funds for extended periods and help users save money over time. They earn interest but limit transaction frequency and require a minimum balance.

External accounts

External accounts are accounts outside Gravv, such as bank accounts and mobile money wallets, that you pay out to. They have their own section: see External accounts.

📘 Note

All internal and external accounts must be associated with a customer.

Next steps

Create a customer account after completing KYC verification.

Fetch a list of accounts or retrieve a single account by ID.

Freeze, reactivate, or close an account.

Link and manage the bank accounts and mobile money wallets you pay out to.

Add test funds to account wallets in the sandbox environment.