Key features
- Fiat funding and withdrawals: Send or receive fiat over wire and other methods Circle supports.
- Stablecoin payins and payouts: Send and receive USDC on supported blockchains. Payins credit each sub-wallet; send payouts from each sub-wallet or the main wallet when enabled.
- Merchant sub-wallets: Give each merchant or customer a separate stablecoin account for clear bookkeeping and audit trails. Use the Accounts API to list, create, and fetch these accounts. Your agreement’s onboarding model determines whether you or Circle provisions them.
- Line of credit and reporting: Borrow USDC on credit when your agreement allows it. Daily and monthly payout and balance reports are available.
- Two onboarding models: Your Managed Payments agreement with Circle sets
which model you use.
- Direct: Circle works directly with your merchants/customers. You collect Know Your Business (KYB) of your merchant and share it with Circle. Circle creates sub-wallets for the merchants/customers after KYB approval.
- Intermediary: Circle doesn’t have to onboard your underlying merchants or customers. You create sub-wallets for each merchant or customer with the APIs.
How it works
Onboard and obtain API access
You join through Circle’s invitation and sign up with a Managed Payments
account. Circle assigns role-based permissions to your API keys, controlling
access to specific capabilities such as sub-wallets, wires, stablecoin payouts,
reports, and balance views. Circle configures these roles during onboarding.
Create merchant sub-wallets
Creating merchant sub-wallets depends on the onboarding process you agree on
with Circle.
- Direct onboarding: You collect end-merchant Know Your Business (KYB) information and share it with Circle through a secure offline channel. Circle creates sub-wallets for those merchants on your behalf.
- Intermediary model: Use the merchant sub-accounts API to create the sub-wallets you need for your merchants. Sub-wallets keep balances separate for tracking and reporting.
Run payin and payout flows
- Payins:
- Create a continuous payment intent for third-party payins so each sub-wallet has a stable USDC receive address.
- After USDC is confirmed, use Fiat Burns to withdraw USDC to fiat in your bank account.
- Payouts:
- Use the Wires API to add bank accounts and wire instructions, then send fiat so Circle credits USDC.
- Use the Payouts API to send USDC onchain to payees you register and approve in the Address Book.
- Line of credit (optional): If your agreement supports it, you can borrow USDC before fiat settles.
API summary
| Area | Purpose |
|---|---|
| Accounts API | List and get stablecoin accounts for self and merchant sub-wallets. |
| Merchant Sub-Account API | Create sub-account wallets for merchants. |
| Payins | Payment intents and Payments for payin flows. |
| Fiat Burns | Withdraw USDC to fiat in your bank when enabled. |
| Payouts | Onchain USDC sends plus funding, Address Book, and Line of Credit when enabled. |
Get started
Pick a quickstart to walk through a managed payment flow:Receive Stablecoin Payins
Payment intents, inbound USDC, and settlement to fiat for your use case.
Send Stablecoin Payouts
Sub-wallets, funding, and USDC payouts for your managed payments use case.