Gateway Environments & Sandbox Simulation
Rook maintains three isolated gateway environments fronted by dedicated enterprise API gateways and global edge routing. Sandbox simulation endpoints allow testing full banking and card operations without real capital or network consequences.
Environment Segregation & URLs
| Environment | Gateway Base URL | Key Prefix | Tenant Scope & Data Isolation |
|---|---|---|---|
| Sandbox | https://api.sandbox.rookpayments.com/v1 | rk_test_... | Simulated rails, automated test mocks, immediate clearing |
| UAT (Staging) | https://api.uat.rookpayments.com/v1 | rk_uat_... | Pre-production network testing, partner institution validation |
| Production | https://api.rookpayments.com/v1 | rk_live_... | Live Federal Reserve FedNow, Visa/Mastercard, NACHA rails (99.99% SLA) |
Sandbox Simulation Operations
Simulation operations are served exclusively on the sandbox host (https://api.sandbox.rookpayments.com) with a rk_test_ key. Sandbox objects never affect production balances, physical cards, or real bank accounts.
Simulating the Complete Issuing & Spend Flow
Test an end-to-end integration lifecycle:
Wallet Entity → Enrollment Review → Application Approval → Wallet → Card → Simulate Authorize → Settle
1. Check System Connectivity
curl https://api.sandbox.rookpayments.com/v1/status \
-H "Authorization: Bearer rk_test_..."2. Simulate Real-Time Authorization
Trigger an inbound authorization without physical point-of-sale hardware:
curl -X POST "https://api.sandbox.rookpayments.com/v1/simulate/cards/crd_8f162a7b/authorizations" \
-H "Authorization: Bearer rk_test_..." \
-H "X-Program-ID: 7c9e6679-7425-40de-944b-e07fc1f90ae7" \
-H "Content-Type: application/json" \
-d '{
"amount": 4500,
"currency": "USD",
"merchant_name": "ACME Cloud Services",
"mcc": "5734"
}'3. Simulate ACH File Processing
Advance pending ACH debits or credits immediately to SETTLED:
curl -X POST "https://api.sandbox.rookpayments.com/v1/simulate/transfers/tx_4a910e/process" \
-H "Authorization: Bearer rk_test_..." \
-H "X-Program-ID: 7c9e6679-7425-40de-944b-e07fc1f90ae7"