Merchant/Partner Settlement in Stablecoins
Provision partner wallets and automate B2B settlements using USD→USDC transfers for faster, cost-effective payments
Summary
Create a Customer for each merchant/partner to provision a custodial wallet, then initiate USD→USDC transfers they complete via hosted/embedded checkout. Use balances and webhooks to confirm settlement status.
Problem → Solution mapping
| Pain | Capability | Mechanism |
|---|---|---|
| Need per-partner accounts | Customers API | Per-partner Customer |
| Settlement confirmation | Webhooks + REST | transfer.completed + GET /v1/transfers/{id} |
| Reporting | Balances API | Periodic GET /balances |
Architecture
Implementation steps
Create partner customer and transfer
Use the standard customer/transfer/checkout/balance requests shown previously.
Webhooks
Subscribe, validate signature, and record settlement only after REST verification.
UX choices
Hosted link for out-of-band settlements; embedded for portal experiences.
KPIs
Settlements completed; average settlement time; retries.
Limits & caveats
USD→USDC only. Settlement is executed by card checkout flow (today).
Troubleshooting
If partner abandons checkout, re-issue the signedUrl; rotate link per new transfer.
Two-Sided Marketplace Escrow-Like Flows
Implement proof-of-funds verification for marketplace transactions without building custom custody infrastructure
In-App Micro-Purchases with Hosted Checkout
Enable frictionless micro-transactions using hosted Payment Links with Apple Pay integration for small-ticket purchases