Environments
The sandbox mirrors live behaviour, adds endpoints to simulate the outside world, and never moves real money.
| Sandbox | Live | |
|---|---|---|
| Base URL | https://sandbox.api.neofin.tech/v1 | https://api.neofin.tech/v1 |
| Keys | sk_test_… | sk_live_… |
| IBANs | Structurally valid, reserved test range, not routable | Routable EUR and GBP account numbers |
| Credits | Created with POST /sandbox/credits | Arrive from real payer banks |
| Shield | Full name matching and rules; screening returns deterministic results by payer name | Full screening against live lists |
| Recalls | Created with POST /sandbox/recalls | Opened by requesting banks |
| Clock | Advance with POST /sandbox/clock/advance to expire sessions and run sweeps | Real time |
| Data retention | 90 days | Per the Terms of Service |
Deterministic screening in sandbox
To test every Shield outcome, use these payer names in POST /sandbox/credits:
| Payer name contains | Screening result |
|---|---|
| SANCTIONED | hit → credit returned with screening_hit |
| PEP | pep → credit held in review |
| REVIEW | Forces credit.in_review regardless of name match |
| anything else | clear |
Advancing the clock
curl https://sandbox.api.neofin.tech/v1/sandbox/clock/advance \
-H "Authorization: Bearer $NEO_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "seconds": 86400 }'Advancing the clock expires open checkout sessions, runs scheduled sweep rules and releases holds whose release_after has passed, emitting the corresponding events.