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

# Simulate payments

> Pay a sandbox account in test mode.

You can't wire real money into a sandbox account, so in test mode the sandbox bank pays it for you. The payment takes the same path as a real one from the bank onwards: charges, the ledger, events and your webhook.

```bash theme={null}
curl https://$MESH_HOST/v1/simulations/inflows \
  -H "X-Api-Key: $MESH_TEST_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "account_number": "6037000014",
    "amount_minor": 150000,
    "sender_name": "Ada Obi",
    "sender_bank_code": "058",
    "narration": "Order 77123"
  }'
```

```json theme={null}
{
  "success": true,
  "data": {
    "session_id": "000013251121090000123456789012",
    "account_number": "6037000014",
    "account_name": "Ada Stores",
    "amount_minor": 150000,
    "status": "queued"
  },
  "message": "…",
  "request_id": "…"
}
```

| Field | |
| - | - |
| `account_number` | Required. One of your wallets, or a static or dynamic virtual account |
| `amount_minor` | Required. 1 to 1,000,000,000 kobo |
| `session_id` | Optional. The NIBSS session id; made up when absent. Sending the same one again is a replay |
| `sender_name`, `sender_bank_code`, `sender_account_number`, `narration` | Optional |

## Try each outcome

| To see | Pay |
| - | - |
| `va.payment.success` | Any amount into a collection account |
| `dva.payment.success` | A one-off account's exact `total_payable_minor` |
| `dva.payment.held` (`mismatch`) | A one-off account any other amount |
| `dva.payment.held` (`duplicate`) | A one-off account that's already paid |
| `wallet.credited` | Any amount into a wallet |

> [!NOTE]
>
> Only test keys can simulate. To a live key the route doesn't exist (`404`), so live money can never be simulated.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.