Settlement
Settlement is the process of converting a merchant’s on-chain USDC balance to USD in their bank account. This happens automatically — integrators don’t need to manage it.How Settlement Works
1
Payment Received
Customer sends USDC to the merchant’s payment address. Fees are split on-chain instantly. The net amount is available in the merchant’s on-chain wallet.
2
Withdrawal Initiated
On the configured schedule (default: weekly Monday 8am EST), USDC is transferred from the merchant’s on-chain wallet to our banking partner for conversion.
3
USD Conversion
Our banking partner (Bridge, a Stripe company) converts USDC to USD at a 1:1 rate. No conversion fee — the stablecoin peg ensures exact dollar equivalence.
4
ACH Deposit
USD is deposited into the merchant’s linked bank account via ACH. Settlement takes 1-3 business days from withdrawal initiation.
Settlement Schedules
Non-Custodial Architecture
Stable Genius never holds merchant funds. Here’s the custody chain:- Customer → Merchant proxy: USDC is sent directly to a smart contract the merchant controls.
- Merchant proxy → Settlement: An authorized operator (Stable Genius) initiates the withdrawal, but only to the merchant’s pre-configured bank account.
- Emergency withdraw: Merchants can call
emergencyWithdraw()directly on their proxy contract to retrieve funds to their own wallet at any time, bypassing Stable Genius entirely.
Settlement Timing
For Integrators
Settlement is fully managed by Stable Genius. As an integrator, you:- Don’t initiate withdrawals
- Don’t manage USDC-to-USD conversion
- Don’t handle bank transfers
- Do receive
settlement.completedandsettlement.failedwebhook events if you want to track settlement status - Do have read access to settlement history via
GET /v1/transactions

