Stable Pro API · v1
Test environment
Staging, test keys and test data: build your integration without touching real accounts.
Staging is a full copy of Stable Pro with test data, for building and testing an integration:
| Production | Staging | |
|---|---|---|
| Base URL | https://app.stable-pro.com/api/v1 | https://staging.stable-pro.com/api/v1 |
| Keys | sp_live_… | sp_test_… |
| Data | real | test data only |
The two environments are separate: a sp_test_ key is refused in production and a sp_live_ key on staging (401, reason: wrong_environment). The contract is the same.
Getting a test key
The owner of a test stable on staging creates the connection in Settings → Connections, exactly as in production, and gives you the sp_test_ key. When the window shows the key, it also says it is a test key that works only in that environment.
What to test
- Read the history from the start with
GET /events, then keep reading from your cursor while someone works in the stable: charges, a discount, a payment with its receipt, a refund. - Handle corrections: an adjustment after an invoice is a new fact, with its reason; your software issues its own document for it, for example a credit note.
- Handle the errors: a revoked key (
401), a missing permission (403), the rate limit (429). - Accept codes you do not know yet: code lists are open.