Skip to main content
How to use PIK’s sandbox environment to simulate payments, FX conversions, and payouts before going live.
PIK provides a full sandbox environment that mirrors production functionality. All API endpoints, webhooks, and dashboard features are available in sandbox. 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. They have separate API keys, separate accounts, separate wallets, and separate data. Nothing you do in sandbox affects production. Sandbox API base URL — https://api-sandbox.pik.tech/v1 Production API base URL — https://api.pik.tech/v1 To switch between environments, change your API key and base URL. No other code changes are needed.

​
Getting sandbox credentials

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

​
Simulating payments

In sandbox, PIK provides a payment simulator. After creating a payment request, instead of sending real funds, call the simulate endpoint to trigger a payment outcome. To simulate a successful payment: call POST /api/v1/sandbox/payments/payment_id /simulate with status set to settled. PIK will process the payment as if funds were received and fire the payment.settled webhook. To simulate an expired payment: call the same endpoint with status set to expired. To simulate an underpaid payment: call with status set to underpaid and include the amount_received field set to a value less than the payment amount.

​
Simulating FX conversions

FX conversions in sandbox execute immediately using simulated rates. The rates returned in sandbox are indicative only and do not reflect live market rates. Use sandbox conversions to test your integration flow — not to validate specific rates.

​
Simulating payouts

Payout requests in sandbox are processed immediately with a simulated success or failure response. To simulate a payout failure, call POST /api/v1/sandbox/payouts/payout_id/simulate with status set to failed and a failure_reason code.

​
Simulating webhook events

Trigger any webhook event manually in sandbox from the PIK Dashboard under Settings > Webhooks > Send test event. Select the event type, fill in the payload fields, and click Send. PIK will deliver the event to your registered endpoint so you can test your webhook handler without running through a full transaction flow.

​
Sandbox limitations

Sandbox does not connect to real banking networks or blockchain networks. Simulated USDT transactions do not appear on the Solana blockchain. Simulated AUD transfers do not go through the Australian banking system. All sandbox data is reset periodically — do not rely on sandbox data being persistent long term.