Production API Request Flow

Recommended request order for live operations with explicit ownership scope and transaction auditability.

1. Authenticate and obtain user JWT or app API key.
2. Create/update products through /v1/products endpoints.
3. Start checkout from Pay with your product ID.
4. Receive and validate callback/webhook signatures.
5. Query transaction outcomes from /v1/transaction/status or /v1/transactions.

Required headers

Authorization: Bearer <token>
Content-Type: application/json

Error-handling baseline

• Retry transient failures (5xx) with exponential backoff.
• Treat 401/403 as auth/permission issues.
• Treat 409 as business conflicts (for example product delete blockers).
• Log transaction ids, webhook event ids, and request ids for traceability.