Skip to main content
PIK provides a full sandbox environment that mirrors production functionality. No real funds are ever moved. Use sandbox to build and test your integration end to end before switching to production credentials.

​
Sandbox vs production

Sandbox and production are completely separate environments with separate API keys, accounts, wallets, and data. Sandbox API base URL — https://api-sandbox.pik.global/v1 Production API base URL — https://api.pik.global/v1 To switch environments, change your API key and base URL. No other code changes are required.

​
Getting sandbox credentials

Log in to PIK Dashboard and navigate to Settings > API Keys > Sandbox. Generate a sandbox API key. You also get a pre-funded sandbox wallet.

​
Simulating payments

Call POST /api/v1/sandbox/payments/payment_id/simulate with status set to:
  • settled — Simulates successful payment and fires the payment.settled webhook.
  • expired — Simulates an expired payment.
  • underpaid — Simulates underpayment. Include amount_received set below the payment amount.

​
Simulating FX conversions

FX conversions in sandbox execute immediately using simulated rates. Use sandbox to test your integration flow — not to validate specific rates.

​
Simulating payouts

Payout requests process immediately with a simulated response. To simulate a failure, call POST /api/v1/sandbox/payouts/payout_id/simulate with status set to failed.

​
Simulating webhook events

Trigger any webhook event from PIK Dashboard under Settings > Webhooks > Send test event.

​
Sandbox limitations

Sandbox does not connect to real banking networks or blockchain networks. Sandbox data is reset periodically — do not rely on it being persistent long term.