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

> ## Agent Instructions
> When building application code, use `@naturalpay/sdk` for TypeScript or `naturalpay` for Python.
> When operating Natural directly for a user, use the payments MCP at `https://mcp.natural.com`.
> When searching Natural documentation, use the docs MCP at `https://docs.natural.com/mcp`.
> Use the Natural CLI for terminal and CI automation.
> Use REST only for unsupported languages or when the user explicitly requests raw HTTP.
> Start integration development and testing in the sandbox. Do not use production unless the user explicitly requests it.
> For sandbox requests that require `customerPartyId`, list customers first. Reuse only the intended fixture; otherwise create a customer.
> REST and SDK amounts use integer minor units. Payments MCP amounts use decimal strings with a required currency code.

# Sandbox

> Experience Natural without moving real money

<img src="https://mintcdn.com/natural-b3c9dd77/pPnF-06H78Do1npA/assets/heroes/sandbox-hero.jpg?fit=max&auto=format&n=pPnF-06H78Do1npA&q=85&s=981aae4ea7465d69aff3a62e86889e1a" alt="The Natural dashboard in sandbox mode" className="hero-image" noZoom width="2400" height="1280" data-path="assets/heroes/sandbox-hero.jpg" />

The sandbox is a complete Natural environment that functions like production.

Point your integration at the sandbox base URL with a sandbox key:

```text theme={null}
https://api.sandbox.natural.com
```

Keys carry their environment in the prefix (`sk_ntl_sandbox_...`, `ak_ntl_sandbox_...`) and never work anywhere else.

Sandbox keys come from the [dashboard](/guides/platform/dashboard): open the account menu in the bottom-left corner (the same menu you sign out from) and flip the **Sandbox** toggle.

## How it behaves

* **No separate onboarding for your organization.** Your verified Natural organization carries over automatically. Test customers become verified when you [accept a pending invitation](/api-reference/simulations/accept-customer-invitation).
* **Money moves instantly.** Transfers and payments settle as soon as you make them. Card payments are the exception: they wait until you [simulate settlement](/api-reference/simulations/settle-card-payment).
* **Isolated.** You can reach your own parties and your [fixtures](/api-reference/sandbox/fixtures), nothing else. No other sandbox organization can see or touch your data.

## What you can do

| Surface | What you can do |
| - | - |
| Connect | [Invite a test customer](/api-reference/simulations/create-test-customer), [accept](/api-reference/simulations/accept-customer-invitation) or [decline](/api-reference/simulations/decline-customer-invitation) the pending invitation, then [fund it](/api-reference/simulations/fund-test-customer), [revoke an agent](/api-reference/simulations/revoke-agent-connection), or [disconnect it](/api-reference/simulations/disconnect-customer) |
| Payments | [Complete a payment claim](/api-reference/simulations/complete-payment-claim) held for an unregistered recipient |
| Payment requests | [Fulfill](/api-reference/simulations/fulfill-payment-request) or [decline](/api-reference/simulations/decline-payment-request) a request as the payer |
| Bank accounts | [Link a test bank account](/api-reference/simulations/link-test-bank-account) to your own party |
| Direct | [Settle](/api-reference/simulations/settle-wire) or [fail](/api-reference/simulations/fail-wire) a wire, [settle](/api-reference/simulations/settle-realtime-payment) or [fail](/api-reference/simulations/fail-realtime-payment) a realtime payment |
| Accept | Pay a checkout link with a [test card](/api-reference/sandbox/card-fixtures), then [settle the card payment](/api-reference/simulations/settle-card-payment) into your wallet; see [Test Accept in Sandbox](/guides/accept/test-in-sandbox) |

Sandbox endpoints live under `/simulations/*` and appear in a Simulations group under each resource they test. The Connect, payment, payment-request, and bank-account actions above are also available from MCP, the SDKs, and the CLI; see [Sandbox from MCP, CLI, and SDKs](/api-reference/sandbox/surfaces).


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