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 or update products through /v1/products (POST, PUT, PATCH); see Products API CRUD and multi-language examples.
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.