# CashWeb Partner API ## Docs - [Cancel a partner transaction safely with idempotent retries](https://docs.cashweb.cash/api-reference/partner-api/cancel-a-partner-transaction-safely-with-idempotent-retries.md): Cancels a partner transaction when the current state allows cancellation. Reuse the same `Idempotency-Key` for retries of the same cancellation intent. - [Create executable quote for partner transaction pricing](https://docs.cashweb.cash/api-reference/partner-api/create-executable-quote-for-partner-transaction-pricing.md): Creates an executable quote for a token and network. Send exactly one amount mode: `crypto_amount` or `fiat_amount`. Quote responses include an expiry timestamp; expired quote IDs will be rejected during transaction creation. - [Create partner transaction with canonical recovery reference](https://docs.cashweb.cash/api-reference/partner-api/create-partner-transaction-with-canonical-recovery-reference.md): Creates a partner transaction and reserves a deposit address. Use `Idempotency-Key` for safe retries and provide a canonical `merchant_reference` for recovery lookups. Request pricing must use either quote mode (`quote_id`) or direct mode (`fiat_amount` + `crypto_currency` + `network`). - [Get transaction status transition history](https://docs.cashweb.cash/api-reference/partner-api/get-transaction-status-transition-history.md): Returns the audited timeline of status transitions for one transaction. Use this endpoint to explain current state and reconciliation progression. - [Get webhook event delivery telemetry by event id](https://docs.cashweb.cash/api-reference/partner-api/get-webhook-event-delivery-telemetry-by-event-id.md): Returns delivery telemetry for a partner webhook event, including current delivery status, attempt count, and last error. Use this endpoint for webhook incident triage and replay diagnostics. - [List partner transactions with cursor pagination](https://docs.cashweb.cash/api-reference/partner-api/list-partner-transactions-with-cursor-pagination.md): Returns partner-scoped transactions in stable descending order (`created_at`, `id`). Use `next_cursor` from the response for pagination. Optional filters support status, merchant dimensions, canonical reference, and RFC3339 time windows. - [List partner webhook events from the local delivery log](https://docs.cashweb.cash/api-reference/partner-api/list-partner-webhook-events-from-the-local-delivery-log.md): Returns partner-scoped webhook events with deterministic cursor pagination for recovery and audit workflows. This endpoint reads CashWeb delivery records only and does not enrich each row with downstream delivery telemetry. - [Read partner revenue ledger with deterministic pagination](https://docs.cashweb.cash/api-reference/partner-api/read-partner-revenue-ledger-with-deterministic-pagination.md): Returns partner-scoped revenue rows for reconciliation and reporting. Use `from`/`to` windows and cursor pagination for deterministic backfills. Optionally request summary totals with `include_summary=true`. - [Recover transaction using canonical merchant reference](https://docs.cashweb.cash/api-reference/partner-api/recover-transaction-using-canonical-merchant-reference.md): Recovery endpoint for partner timeout scenarios. Looks up a transaction by partner-scoped canonical `merchant_reference` and returns the same snapshot shape as `GET /transactions/{id}`. - [Replay a previously created partner webhook event](https://docs.cashweb.cash/api-reference/partner-api/replay-a-previously-created-partner-webhook-event.md): Requeues an existing partner webhook event for redelivery without minting a new logical event id. - [Retrieve partner transaction by transaction id](https://docs.cashweb.cash/api-reference/partner-api/retrieve-partner-transaction-by-transaction-id.md): Returns the latest transaction snapshot for the authenticated partner. Use this endpoint for direct status checks after create, cancel, or webhook processing. - [Simulate partner transaction lifecycle events in non-production](https://docs.cashweb.cash/api-reference/partner-api/simulate-partner-transaction-lifecycle-events-in-non-production.md): Sandbox-only endpoint for simulating partner transaction lifecycle events. You must first create a transaction and pass its returned `id` as `transaction_id` in the request body. This route is mounted only in non-production environments and hard-rejects when called against production state. - [Authentication](https://docs.cashweb.cash/docs/authentication.md): API key authentication and partner data scoping behavior. - [Errors](https://docs.cashweb.cash/docs/errors.md): Structured error model and endpoint-specific handling guidance. - [Go-Live Checklist](https://docs.cashweb.cash/docs/go-live-checklist.md): Production readiness checklist for partner API consumers. - [Idempotency](https://docs.cashweb.cash/docs/idempotency.md): Safe retry contract for partner write operations. - [Introduction](https://docs.cashweb.cash/docs/introduction.md): CashWeb Partner API overview for transaction execution, webhook consumption, and reconciliation. - [Quickstart](https://docs.cashweb.cash/docs/quickstart.md): End-to-end partner integration flow with concrete request and recovery patterns. - [Rate Limits](https://docs.cashweb.cash/docs/rate-limits.md): How to handle partner API throttling safely in production. - [Receiving Crypto](https://docs.cashweb.cash/docs/receiving-crypto.md): How CashWeb receives seller deposits and how partners should track them. - [Revenue](https://docs.cashweb.cash/docs/revenue.md): Ledger retrieval and deterministic reconciliation strategy for partner revenue. - [Sandbox](https://docs.cashweb.cash/docs/sandbox.md): Test your integration against the CashWeb staging environment before going live. - [Supported Networks](https://docs.cashweb.cash/docs/supported-networks.md): Tokens, networks, and identifiers accepted by the Partner API. - [Transaction Lifecycle](https://docs.cashweb.cash/docs/transaction-lifecycle.md): Status model, transition intent, and operator interpretation for partner transactions. - [Transactions](https://docs.cashweb.cash/docs/transactions.md): Create, recover, list, and cancel partner transactions with production-safe patterns. - [Webhook Events](https://docs.cashweb.cash/docs/webhook-events.md): Complete event catalog and payload contract for partner webhook consumers. - [Webhook Recovery](https://docs.cashweb.cash/docs/webhook-recovery.md): Operational runbook for missed, delayed, duplicate, or compact webhook payloads. - [Webhook Security](https://docs.cashweb.cash/docs/webhook-security.md): Signature verification, replay controls, and handler hardening guidelines. - [Webhooks](https://docs.cashweb.cash/docs/webhooks.md): Delivery model and consumption requirements for financial-grade webhook processing. ## OpenAPI Specs - [openapi](https://docs.cashweb.cash/openapi/openapi.json)