Getting started

Environments

Two isolated environments — sandbox and production.

Each environment has its own keys, ledger, and webhook delivery. Test keys never reach real provider rails — they hit the sandbox cascade and return deterministic responses.

Sandbox

Base URLhttps://sandbox-api.key2pays.com/v1
Key prefixsk_test_… / pk_test_…
  • Deterministic test cards & SPEI references (see Test data).
  • Free of charge. No real money movement.
  • Webhook signatures use the per-merchant test webhook secret.

Production

Base URLhttps://api.key2pays.com/v1
Key prefixsk_live_… / pk_live_…
  • Real provider cascade and crypto settlement.
  • Rate-limited per merchant — see the Rate limits section.
  • All requests must use TLS 1.2 or newer.
Currently active in this docs site: sandbox. Toggle the environment in the top navigation to swap base URLs and key examples across every page.