Handling Deposits
Choosing between Widget-Managed and API-Managed deposits
The Plug & Pay SDK supports two deposit modes. Your partner account is configured for one or the other — pick the guide that matches your setup.
Which Mode Do I Use?
| Mode | What the widget does | What your app does | Supported tokens/networks | Use when |
|---|---|---|---|---|
| Widget-Managed Deposits | The widget runs the full deposit UI — token selection, network selection, amount entry — and hands your app a signed-ready transaction via onTransactionRequested. | Sign and broadcast the transaction the widget prepared. | Limited set — USDC/USDT on Ethereum, USDT on BNB Smart Chain, USDC/USDT on Solana. | You want the fastest integration and are happy with the built-in deposit UX. |
| API-Managed Deposits | The widget fires onDepositRequested when the user taps "Add Funds" — no built-in deposit UI. | Show your own deposit page. Your backend fetches a deposit address via the Oobit Partner API; the user sends to it. | Broader — more chains and tokens. Fetch the full list from the List Crypto Currencies API. | You need full control over the deposit UX, or you want to surface more tokens/networks than the widget offers. |
Note: The mode is set at the partner-account level. If you're not sure which one you're on, contact your Oobit account manager.
See Also
- Widget-Managed Deposits — Handling
onTransactionRequested, EVM and Solana signing - API-Managed Deposits — Using the Partner API to fetch deposit addresses
- Testnet Resources — Faucets and testnet token contracts for local testing
Updated 3 days ago