Wallets Overview

Celar provides custodial wallets for every PSP organization.
These wallets are used to receive, store, and send stablecoins across supported chains.

A wallet is identified by a unique celar_walletId and is required for all payment operations:

• Pay-ins → funds settle into a custodial wallet after confirmation.
• Payouts → executed from a custodial wallet to a customer.
• Withdrawals → transfer funds from a custodial wallet to your registered external wallet.

Wallet Lifecycle

1. Create a Wallet

   • Every PSP must create at least one custodial wallet after onboarding.
   • The API assigns a unique celar_walletId.

2. Fund the Wallet

   • Funds arrive automatically when customer pay-ins settle.

3. Use the Wallet

   • As a source for payouts or withdrawals.
   • As a destination for pay-ins.

4. Reconcile

   • Track balances using the Wallet Balance API.
   • Use wallet history to reconcile inflows (pay-ins) and outflows (payouts, withdrawals).