Shadow / Demo Mode — all data is simulated for evaluation. paykx.co.uk ↗
Sandbox Integration

PAYKX → Payment Gateway

Real-time simulated execution flow. Chain a PAYKX corridor decision with a Flutterwave or Paystack sandbox call — then validate whether the prediction matched the outcome.

How it works

PAYKX runs first. If the decision is GO or DEGRADED, the selected gateway is called. If NO-GO, the gateway never receives the request — that's the design.

Getting sandbox keys

Flutterwave: developer.flutterwave.com → Dashboard → API Keys → Test Secret Key.
Paystack: dashboard.paystack.com → Settings → API Keys → Test Secret Key.

Scenario library — run automated tests
🇳🇬 Nigeria
Bank unavailable
Tests GO path when counterparty bank is operational but under stress. PAYKX assesses network path before executing.
GO expected£2,500 · GB-NG
🇳🇬 Nigeria
High FX volatility
FX risk signal elevated. Amount crosses £50k policy cap — score capped at 0.74. Tests DEGRADED path with flagged execution.
WAIT expected£65,000 · GB-NG
🇳🇬 Nigeria
Beneficiary mismatch
Partner compliance signal triggered. Amount in compliance review zone. Tests DEGRADED path via Paystack for comparison.
WAIT expected£35,000 · GB-NG
🇳🇬 Nigeria
Delayed settlement
High-value transfer with settlement timing risk. Probes: historical_rate detects PDNG pattern on this corridor amount band.
WAIT expected£85,000 · GB-NG
🇰🇪 Kenya corridor simulation
M-Pesa recovery path
Mobile wallet timeout scenario. Network probe assesses mobile provider availability on East Africa–calibrated parameters. Small amount stays below policy caps.
GO expected£1,800 · GB-NG
🇰🇪 Kenya execution scenario model
Settlement delay risk
Mobile wallet unavailability and corridor settlement delay combined. £50k+ amount band triggers DEGRADED path — tests WAIT decision under East Africa risk parameters.
WAIT expected£58,000 · GB-NG
Configure test
Payment gateway
Compare risk profiles — no API key needed

See how the same payment scores across conservative, balanced, and optimise_speed risk profiles in one call. Uses POST /api/v1/demo-compare — public, no key required.

What to try

GO scenario

£1,500 — below all policy caps. PAYKX returns GO, gateway is called.

DEGRADED scenario

£75,000 — above £50k cap. PAYKX caps score, gateway still called but flagged.

NO-GO scenario

£600,000 — above £500k cap. PAYKX blocks. Gateway never called.

Compare risk profiles — no API key needed

Try POST /api/v1/demo-compare

Score the same payment against conservative, balanced, and speed-optimised profiles in a single call. Use amount: 85000 to see profiles diverge — conservative and balanced return DEGRADED while speed-optimised returns GO.

View full reference →