Banqi HTTP API
Every endpoint that powers the agent portal, the admin console, and the public catalog. The same surface the dashboard talks to — so what you see here is exactly what ships. All endpoints accept application/json and return JSON.
Getting started
2 endpointsBase URL, auth, idempotency, rate limits, and how errors are returned.
Auth
9 endpointsMerchant / admin / platform sign-in. Returns a JWT you send in `Authorization: Bearer …`.
User (Banqi agent portal)
11 endpointsEndpoints the signed-in agent calls. All require `Authorization: Bearer <banqi_jwt>`.
TRC-20 + Multi-chain
3 endpointsBanqiPay-managed on-chain read + tooling endpoints. Per Q2 the user-facing send is now done via the BanqiPay custodial / card top-up flow. Fees: 0.25% P2P transfer (USDT/USDC).
Admin (back-office)
54 endpointsMerchant scoping enforced via `x-admin-merchant-id`. Super-admins (`admin_users.role = "platform"`) can cross merchants.
KYC / KYB
8 endpointsIdentity verification flows. Users submit; admins approve; KYB is per-merchant.
Merchant (business banking)
9 endpointsPer-merchant endpoints for the business banking portal (KYB-verified businesses).
Webhooks
1 endpointOutbound webhooks. HMAC-SHA256 signed. Replayable from the admin audit log.
P2P transfer (BanqiPay balance)
6 endpointsP2P transfer routes. The internal-ledger route (resolve-recipient + internal-transfer + internal-history) is the canonical P8.I path; the legacy self-custody path (resolve + transfer-receipt + history) is frozen for Q5=c returning users only.
Card API (BanqiPay card surface)
external docBanqiPay card surface endpoints (proxy to https://pay.banki.io/api-docs/#card-overview). Mounted at /api/v1/card/*. The 26 active routes are documented at the upstream BanqiPay doc — this page links out rather than maintaining a local copy that could go stale.
US Card API (BanqiPay US Card surface)
external docBanqiPay US Card surface endpoints (proxy to https://pay.banki.io/api-docs/#uscard-overview). US-issued cards have a separate endpoint group from the international card surface in section 11 — KYC, BIN, and shipping flows differ. The full set is documented at the upstream BanqiPay doc.
Errors
1 endpointAll error responses follow a consistent shape. HTTP status is also set correctly.
Auth examples
Authorization: Bearer eyJ… # banqi_jwt = base64(<userId>:<merchantId>)
Authorization: Bearer <jwt>
Authorization: Bearer <jwt> # banqi_jwt = base64(<userId>:<merchantId>)