Developer documentation
Sandbox and test strategy
Exercise full integration behavior without mixing test credentials into live operations.
Environment separation
Create keys with environment=test for development and automated verification. Test keys use the rcn_test_ prefix, which makes accidental environment mixing visible in logs and configuration reviews.
Do not use fictional data in live
Keep synthetic subjects, accounts and events in the test environment. Never copy real API keys or production subject data into local fixtures.
A useful test fixture
- Create one individual and one organisation.
- Create a current account for each, then replay payment, delinquency, cure, default and closure paths permitted by the state machine.
- Verify duplicate account IDs and source references are rejected.
- Retry idempotent creates with identical bodies, then confirm key reuse with a changed body returns 409.
- Query NR subjects as well as rated subjects and assert that your UI does not render NR as a numeric score.
- Generate a signed test webhook and validate it through the same production verifier.
- Exercise 401, 403, 404, 409, 413, 422, 429 and 500 handling in staging.
Promotion to live
- Issue a new live key; never change a test prefix or reuse a test secret.
- Use independent idempotency namespaces and external account identifiers.
- Point webhooks to a production HTTPS endpoint with monitoring enabled.
- Run a single controlled subject/account/event/profile workflow, reconcile it, then expand traffic gradually.