API & webhook posture

Buyer engineers integrating reseller automation should align with billing portal tokens from the authenticated client area — follow official module docs surfaced there rather than scraped examples.

Retries & idempotency

• Use deterministic client request IDs server-side whenever your bridge replays payloads after regional network brownouts.
• Backoff exponentially; avoid tight loops that amplify incident load during partial API degradation.
• Webhook consumers should ACK after durable queue write — reconciling late duplicates beats silent drops.

Operational comms during outages

Assume /status/ aggregates customer-visible breakage; ticketing remains authoritative for SLA correlation. Embed health badges per status-integration notes.

Finance hooks

Gateways return asynchronous settlement signals — reconcile with invoice PDF artefacts in-client area rather than assuming immediate ledger finality inside webhooks alone.