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

# Sandbox Simulate

> Mark a test checkout as paid without moving real money

`POST /v1/checkout/sandbox/simulate`

Test-mode only (`sk_test_...` / `pk_test_...`) — marks a test checkout as paid (or failed) without any real money moving, so you can test your integration end-to-end.

<ParamField body="reference" type="string" required>
  The `reference` from a checkout initialized in test mode
</ParamField>

<ParamField body="status" type="string" default="success">
  `success` or `failed`
</ParamField>

```bash theme={null}
curl -X POST "https://api.payracle.com/api/v1/checkout/sandbox/simulate" \
  -H "Authorization: Bearer sk_test_YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"reference": "PAY-A1B2C3D4E5", "status": "success"}'
```

Calling this with a live key returns a `403`:

```json theme={null}
{ "status": false, "message": "Simulation is only available with sandbox (test) API keys." }
```

A successful simulation fires the same [webhook](/webhooks/overview) a real payment would, so you can test your webhook handler end-to-end too.