API Reference
Base URL is versioned under /api/v1. All writes require an Idempotency-Key.
Auth
| POST | /api/v1/oauth/token | OAuth2 client-credentials → JWT |
Wallets
| POST | /api/v1/wallets | Create a sponsored wallet (idempotent) |
| GET | /api/v1/wallets/{id} | Get a wallet |
| GET | /api/v1/wallets/{id}/balances | Rebuildable balance read-model |
Assets & loyalty
| POST | /api/v1/assets | Create an asset |
| POST | /api/v1/assets/{id}/activate | Activate |
| POST | /api/v1/assets/{id}/issue | Issue |
| POST | /api/v1/assets/{id}/transfer | Transfer |
| POST | /api/v1/assets/{id}/redeem | Redeem |
| POST | /api/v1/assets/{id}/earn | Earn via rules engine |
Transactions
| GET | /api/v1/transactions/{id} | Get a transaction |
| POST | /api/v1/transactions/{id}/compensate | Business reversal (maker-checker over threshold) |
Stablecoins (flag-gated, OFF by default)
Disabled until PayChain readiness gates pass — see the Admin portal › Readiness.
| POST | /api/v1/stablecoins | Create (control plane) |
| POST | /api/v1/stablecoins/{id}/mint-requests | Mint saga (reserve-confirm first) |
| POST | /api/v1/stablecoins/{id}/redemptions | Redemption saga (burn after payout) |
| POST | /api/v1/conversions/quote | Loyalty→stablecoin quote |
Webhooks & health
| POST | /api/v1/webhooks | Register an endpoint (secret returned once) |
| GET | /api/v1/health | Liveness |
| GET | /api/v1/health/blockchain | Stellar provider health |
