Sandbox & test cards
The dev environment is the sandbox. All API calls, orders, and payments in dev are isolated from production. No real money moves.
Dev environment URLs
| Service | URL |
|---|---|
| API | https://pos-api.dev.apps.myfinterra.com |
| Admin portal | https://admin.dev.apps.myfinterra.com |
| POS | https://pos.dev.apps.myfinterra.com |
| Docs | https://docs.dev.apps.myfinterra.com |
| Token endpoint | https://tilt-m2m-dev.auth.us-east-1.amazoncognito.com/oauth2/token |
Valor sandbox card numbers
These numbers work in the dev environment only. Use any future expiry date (e.g. 12/26), any 3-digit CVV, and any 5-digit ZIP.
| Card number | Network | Result |
|---|---|---|
4111 1111 1111 1111 | Visa | Approved |
4000 0000 0000 0002 | Visa | Declined — do not honor |
5500 0000 0000 0004 | Mastercard | Approved |
3714 4963 5398 431 | Amex | Approved |
6011 1111 1111 1117 | Discover | Approved |
Triggering specific scenarios
| Scenario | How to trigger |
|---|---|
| Approved payment | Any approved card number above |
| Declined payment | Card 4000 0000 0000 0002 |
| Partial approval | Not currently supported in sandbox |
| Refund | Create an approved payment, then call the refund endpoint |
| Void | Create an approved payment, then call the void endpoint before midnight |
Webhook testing
Use webhook.site to get a temporary HTTPS URL for webhook delivery testing. Register it as an endpoint in the admin portal (Integrations tab) and watch events arrive in real time.
API keys and secrets
Sandbox M2M clients are managed in the dev admin portal. They are separate from production clients — a dev client_id/secret will not work against the production API.
Rate limits in sandbox
Rate limits are enforced in the sandbox at the low tier by default, regardless of the client’s configured tier. If you need higher limits for load testing, contact your account manager.
Known sandbox limitations
- Settlement simulation: payments move from
approvedtosettledon a simulated nightly batch (runs at midnight UTC). In production, settlement timing is processor-dependent. - Processor webhooks (Aeropay): async ACH settlement events may be delayed up to 1 minute in sandbox vs. near-real-time in production.