Integration Map · Section 2 of 4: Systems and architecture
API note
Billing platform
- API
- REST, JSON
- Auth
- OAuth 2.0, short-lived access tokens
- Rate limit
- ~100 requests/sec per account
- Webhooks
- Yes, at-least-once delivery
- Gotcha
- Idempotency keys required on retries, or a timed-out call can create a duplicate invoice.
Risk 1 of 3 · High
Duplicate customer records
Customers are created in both the CRM and Billing with no shared ID. Every new sync will multiply them unless one system owns the customer record.
Recommendation: make the CRM the source of truth, store its ID in Billing, and match on it before creating anything.