Skip to main content
Settlement converts each new deposit to USDC and moves it to the same user’s address on one network you choose. It’s off by default. Configure it with GET/PUT /api/v1/settlement.
Settlement moves funds to the user’s address on your settlement network. Auto-sweep moves funds to your master wallet, and still runs on the settlement network.

What happens to a deposit

With Polygon as the settlement network, a USDT deposit on Ethereum arrives as USDC at the user’s Polygon address.
  • USDC deposits already on the settlement network aren’t settled.
  • Solana isn’t supported. Solana deposits stay on Solana.
  • Deposits below the minimum aren’t moved and show skipped_below_minimum.

Keeping track

Settled deposits have a settlement object. See get a wallet’s deposits, or wait for wallet.deposit.settled. status is one of:

If a settlement fails

We tell you where the money is, in one of three ways:
  • On the network where the deposit arrived. Safe at your user’s own address, in the coin they sent.
  • On Base. Safe at your user’s own address, as USDC.
  • Under review. We’re still confirming where it is and looking into it. That doesn’t mean it’s unsafe, only that we won’t name a place until we’re sure.
Whichever it is, the money still belongs to your user. A failed settlement means the automatic move didn’t finish, not that money is missing.

Cashing out to M-Pesa or a bank

With Base as the settlement network, pay a settled balance out to local currency with an off-ramp order using funding_wallet_ref. Wait for wallet.deposit.settled before creating the order.

Changing your settlement network

Changes apply to new deposits only. In-progress settlements aren’t redirected.