Reference
Protocol reference
Canonical details for request headers, webhook events, and error handling.
Request headers
- Authorization: Bearer cg_live_... (API key attribution path)
- X-Referrer-Wallet + X-Referrer-Sig (signed attribution)
- X-Payment (base64 x402 payload)
Webhook events
- call.attributed — attribution resolved
- call.settled — settlement + split finalized
- call.failed — settlement/distribution failure
Error classes
- 401 Unauthorized — invalid or missing auth material
- 402 Payment required — missing/invalid payment payload
- 409 Conflict — taken handle or conflicting resource state
Limits and retries
- Webhook deliveries retry with backoff and eventually dead-letter.
- Proxy requests are rate-limited by caller tier (api key, signed, unsigned).
- Downstream consumers should be idempotent by deliveryId.