> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pik.global/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox & Testing

> How to use PIK's sandbox environment to test payments, FX conversions, and payouts without moving real funds.

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

### Sandbox vs Production

| Property      | Sandbox                                                                | Production                                             |
| :------------ | :--------------------------------------------------------------------- | :----------------------------------------------------- |
| API base URL  | [https://api-sandbox.pik.global/v1](https://api-sandbox.pik.global/v1) | [https://api.pik.global/v1](https://api.pik.global/v1) |
| Dashboard URL | [dashboard.pik.global](http://dashboard.pik.global)                    | [dashboard.pik.global](http://dashboard.pik.global)    |
| Funds         | Simulated — no real money                                              | Real funds                                             |
| API key       | Sandbox key (separate from production)                                 | Production key                                         |
| Webhooks      | Delivered to your registered endpoint                                  | Delivered to your registered endpoint                  |
| Data          | Reset periodically                                                     | Persistent                                             |

To switch environments, change your API key and base URL. No other code changes required.

### Getting Sandbox Credentials

Log in to the PIK Dashboard at [dashboard.pik.global](http://dashboard.pik.global) and go to Settings > API Keys > Sandbox. Generate a sandbox API key. You also receive a pre-funded sandbox wallet for testing.

### Simulating Payments

http

```text theme={null}
POST /api/v1/sandbox/payments/{payment_id}/simulate
Authorization: Bearer YOUR_SANDBOX_API_KEY
Content-Type: application/json
```

| Status to simulate | Body                                               |
| :----------------- | :------------------------------------------------- |
| Successful payment | "status": "settled"                                |
| Expired payment    | "status": "expired"                                |
| Underpaid payment  | "status": "underpaid", "amount\_received": "50.00" |
| Overpaid payment   | "status": "overpaid", "amount\_received": "150.00" |

### Simulating Payouts

http

```text theme={null}
POST /api/v1/sandbox/payouts/{payout_id}/simulate
Authorization: Bearer YOUR_SANDBOX_API_KEY
Content-Type: application/json
```

| Status to simulate | Body                                                              |
| :----------------- | :---------------------------------------------------------------- |
| Successful payout  | "status": "completed"                                             |
| Failed payout      | "status": "failed", "failure\_reason": "invalid\_account\_number" |

### Simulating Webhook Events

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

### Sandbox Limitations

* Sandbox does not connect to real banking networks or live blockchain networks
* Simulated stablecoin transactions do not appear on any live blockchain — no real network activity occurs
* Simulated AUD transfers do not go through the Australian banking system
* Sandbox data is reset periodically — do not rely on it for long-term persistence