Introduction

CashWeb Partner API overview for transaction execution, webhook consumption, and reconciliation.

CashWeb Partner API lets you quote, create, track, cancel, and reconcile crypto-to-fiat offramp transactions.

Base URLs

Environment	URL
Production	https://api.cashweb.cash/api/v1/partner
Staging	https://dev.cashweb.cash/api/v1/partner

What You Can Do

• Generate executable quotes for supported token and network pairs.
• Create transactions with idempotent retries and canonical merchant references.
• Recover transactions by merchant_reference after client or network timeouts.
• Receive lifecycle webhooks for operational state changes.
• Query delivery telemetry for webhook troubleshooting.
• Reconcile partner revenue using a cursor-based ledger endpoint.

Core Integration Principles

1. Treat merchant_reference as your canonical business key.
2. Use Idempotency-Key on all write operations.
3. Process webhooks as at-least-once and out-of-order.
4. Build reconciliation workflows around API reads, not webhook delivery alone.

Integration Sequence

1. Configure API key authentication.
2. Implement quote and transaction creation flow.
3. Persist transaction IDs + merchant references.
4. Implement webhook signature verification and idempotent processing.
5. Add recovery jobs for transaction and webhook reconciliation.
6. Validate go-live checklist before production traffic.