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 |
|---|---|
| Single-host environment model | One API host; the key prefix selects test vs. live mode |
| API keys | csk_test_ vs csk_live_; 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 | Minor units (cents); USD-only at MVP 0 |
| Authentication model | Bearer token; key hierarchy |
| Transaction lifecycle | State machine from requires_action to settled |
| Audit logging | What Cresora logs; retention periods |
| API versioning | Stable vs. preview streams; deprecation policy |