Core Concepts
Core Concepts
Foundational concepts for building on the Cresora Commerce platform.
Understanding these concepts will make the rest of the documentation click. Read them in order before diving into integration guides.
Concepts in this section
| Concept | Why it matters |
|---|---|
| Environment model | Separate sandbox and production hosts; the host selects the environment |
| API keys | csk_{prefix}_{secret} format; rotation; scoping |
| Idempotency | How to avoid duplicate charges across retries |
| Rate limiting | Request limits and backoff behavior |
| Pagination | Cursor-based listing of resources |
| Amounts & currency | Decimal strings ("100.00"); USD-only at MVP 0 |
| Authentication model | Bearer token; key hierarchy |
| Transaction lifecycle | The 15-state machine, from INITIATED to SETTLED |
| Audit logging | What Cresora logs; retention periods |
| API versioning | The stable stream and planned operations; how changes are announced |