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

# Suby Sandbox

> Test payments end-to-end without touching real funds.

The Suby Sandbox mirrors the full production experience. Create products, simulate card and crypto payments, and verify webhooks, all in a safe testing environment.

<Frame>
  <img src="https://mintcdn.com/suby/_7khuBgqYog1Ce4L/images/sandboxtest.png?fit=max&auto=format&n=_7khuBgqYog1Ce4L&q=85&s=0020ce213b71c8d97424003e064feb0e" alt="Sandboxtest" width="2922" height="1656" data-path="images/sandboxtest.png" />
</Frame>

## Create a test product

You can create a product in sandbox mode using any of these methods:

<CardGroup cols={3}>
  <Card title="Product Link" icon="link">
    Create a product from the dashboard, no code required. Generate a PayLink and share it to test the full checkout flow.
  </Card>

  <Card title="API" icon="code">
    Programmatically create products, checkout sessions, and manage subscriptions via the Suby API.
  </Card>

  <Card title="Sandbox API" icon="flask">
    Use the sandbox base URL to test the full API lifecycle without side effects.
  </Card>
</CardGroup>

## Simulate a payment

Once your product is created, open the generated checkout link to run a test payment:

```text theme={null}
https://checkout.suby.fi/p/pro_nh5ts1yir4hva744jpvln1ek
```

<Frame>
  <img src="https://mintcdn.com/suby/ChI8aNH5BFO_eI9p/images/sandboxpaylink.png?fit=max&auto=format&n=ChI8aNH5BFO_eI9p&q=85&s=5e3a08cd1db1cf51852e971b38514179" alt="Sandboxpaylink" width="2924" height="1656" data-path="images/sandboxpaylink.png" />
</Frame>

\
You can pay with a test card or with crypto on Base Sepolia testnet.

<Tabs>
  <Tab title="Card">
    Use these test card numbers at checkout to simulate different outcomes. Any future expiration date, any CVC, any billing address.

    | Card number           | Result             |
    | :-------------------- | :----------------- |
    | `4242 4242 4242 4242` | Success            |
    | `4000 0000 0000 0002` | Declined           |
    | `4000 0000 0000 9995` | Insufficient funds |

    <Note>
      Any other card number will be declined.
    </Note>
  </Tab>

  <Tab title="Crypto">
    The sandbox supports **USDC** and **ETH** on the **Base Sepolia** testnet. You'll need testnet tokens to simulate a payment.

    ### Get testnet tokens

    | Token    | Faucet                                                                           |
    | :------- | :------------------------------------------------------------------------------- |
    | **USDC** | [faucet.circle.com](https://faucet.circle.com/)                                  |
    | **ETH**  | [alchemy.com/faucets/base-sepolia](https://www.alchemy.com/faucets/base-sepolia) |

    ### Pay at checkout

    Two options are available at the checkout page:

    * **WalletConnect** — connect your wallet (MetaMask, Rainbow, etc.) and approve the transaction on Base Sepolia.
    * **Direct deposit** — send tokens directly to the payment address displayed at checkout.

    <Warning>
      Make sure your wallet is connected to the **Base Sepolia** network before initiating a payment.
    </Warning>
  </Tab>
</Tabs>

## Verify the payment

After completing a test payment, head to your [dashboard](https://app.suby.fi/) to check the transaction status, inspect webhook deliveries, and confirm that your integration works as expected.

<Tip>
  You can also listen for sandbox webhooks to test your backend logic. Webhook events in sandbox mode are identical to production.
</Tip>

<CardGroup cols={2}>
  <Card title="API reference" icon="code" href="/v2/api-reference/introduction">
    Endpoints, authentication, and webhooks.
  </Card>

  <Card title="PayLinks" icon="link" href="/v2/docs/features/paylinks">
    Generate and share checkout links.
  </Card>
</CardGroup>