Create a payment with escrow, compliance screening, and approval rules in a single call. Test on Base Sepolia and Solana devnet today; the same integration carries to mainnet.
orchestrationType: "coinbax" runs the payment through programmable escrow with the controls defined on your template. Compliance screening runs before funds move. The response returns the transaction inPENDING with a unified success / data / meta / error envelope.
curl -X POST https://api.coinbax.com/api/v1/transactions \
-H "X-API-Key: $COINBAX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"fromAddress": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb2",
"toAddress": "0x8ba1f109551bD432803012645Ac136ddd64DBA72",
"amount": 25000,
"currency": "USDC",
"blockchainNetwork": "base",
"orchestrationType": "coinbax",
"templateId": "<your-template-id>"
}'Pass an idempotencyKey on any create call. Retries never double-move money.
Header-based keys with granular permission scopes, or OAuth 2.0 client credentials for service-to-service flows.
Transaction lifecycle events delivered with circuit-breaker-protected retry, so your ledger never silently drifts.
Every payment moves through four enforced phases. Controls execute inside each phase, webhooks report every transition, and the states below are what your integration observes.
Compliance screening and risk scoring run before funds move. Failed payments never reach the contract.
PENDING · RISK_REVIEWFunds lock into the escrow contract defined by your template. A webhook fires when escrow confirms on-chain.
ESCROWEDReview windows, approvals, and rollback triggers execute. Your integration can hold, approve, or recall here.
IN_REVIEWThe contract releases funds and records the result. Terminal states arrive by webhook with the full audit trail.
COMPLETED · REFUNDEDEvery response carries X-RateLimit-Limit,X-RateLimit-Remaining, and X-RateLimit-Reset headers. Errors return structured codes in the same envelope as successes, so one parser handles every outcome.