API Integration
Going Live
Checklist for moving from staging to production
Environments
| Environment | Base URL | Purpose |
|---|---|---|
| Staging | https://staging.rbfoffercalc.com | Integration testing |
| Production | https://app.rbfoffercalc.com | Live traffic |
Integration Checklist
1. Authentication
- HMAC signature computation verified against staging
- Production API key obtained from FoxCalc team
- Clock synchronization (NTP) configured on your servers
2. Offer Creation
- Create offer with all required fields
- Verify calculator URL loads correctly
- Test with optional fields (fees, prepayment, stipulations)
- Test
PUT(replace) andPATCH(partial update) flows - Test
DELETE(revoke) — verify calculator shows revoked state
3. Submission Handling
- Callback endpoint implemented and accessible from the internet
- HMAC signature verification on incoming webhooks
- Parse full submission payload (computed terms, fees, attachments)
- Handle attachment download URLs (pre-signed, time-limited)
4. Error Handling
- Handle 401 (re-sign and retry)
- Handle 409 (fetch latest version and retry)
- Handle 429 (respect
X-RateLimit-Reset) - Handle 5xx (exponential backoff)
5. Webhooks
- Subscribe to relevant event types
- Verify webhook signatures
- Handle
submission.callback_failed(alert your team) - Implement idempotency (deduplicate by
deal_id+timestamp)
6. Go Live
- Switch API base URL from staging to production
- Update callback URL to production endpoint
- Update webhook subscription URLs
- Monitor first 10 live deals end-to-end
- Confirm submission emails arrive to notification recipients