ROOKDocs
5 min readUpdated August 2026

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

EnvironmentGateway Base URLKey PrefixTenant Scope & Data Isolation
Sandboxhttps://api.sandbox.rookpayments.com/v1rk_test_...Simulated rails, automated test mocks, immediate clearing
UAT (Staging)https://api.uat.rookpayments.com/v1rk_uat_...Pre-production network testing, partner institution validation
Productionhttps://api.rookpayments.com/v1rk_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"
Was this page helpful?