> For the complete documentation index, see [llms.txt](https://docs.txn.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.txn.io/getting-setup/making-a-test-payment.md). # Making a test payment The Sandbox settles deposits on public **test networks**, so you can run the full payment flow end to end without moving real funds. This guide shows how to fund a test wallet and pay a Sandbox invoice or channel. We recommend testing with **TRON** — TRX (`ttrx`) and USDT on TRON (`ttrx:usdt`). Both run on the TRON **Shasta** testnet: confirmations are fast, fees are negligible, and test tokens are easy to obtain. `ttrx:usdt` also mirrors the most common production integration — stablecoin deposits. {% hint style="info" %} Sandbox network codes are testnet-prefixed. `ttrx` and `ttrx:usdt` both map to the TRON Shasta testnet. See [Supported currencies](/api-basics/supported-currencies.md) for the full list. {% endhint %} ## 1. Install a TronLink wallet [TronLink](https://www.tronlink.org) is the most widely used TRON wallet and supports the Shasta testnet. It is available as a browser extension and a desktop app — choose whichever suits your workflow. **Browser extension** 1. Open the [TronLink website](https://www.tronlink.org) and choose your browser, or install directly from the [Chrome Web Store](https://chromewebstore.google.com/detail/tronlink/ibnejdfjmmkpcnlpebklmnkoeoihofec) or [Firefox Add-ons](https://addons.mozilla.org/firefox/addon/tronlink-wallet/). 2. Open the extension and select **Create Wallet** (or **Import Wallet** if you already have a test seed phrase). 3. Set a password and securely store your recovery phrase. **Desktop app** 1. Download the desktop app for macOS or Windows from the [TronLink website](https://www.tronlink.org). 2. Install it, then create or import a wallet as above. {% hint style="warning" %} Use a dedicated wallet for testing. Never import a seed phrase that controls real funds into a test setup. {% endhint %} **Switch to the Shasta testnet** 1. Open TronLink and click the network selector at the top of the window. 2. Select **Shasta** (Shasta Testnet). Your balances and transactions now refer to the testnet rather than mainnet. ## 2. Get test tokens You need a small amount of **test TRX** to cover network fees. For USDT tests you also need **test `ttrx:usdt`**. * **Public faucets.** Follow TRON's [Getting testnet tokens](https://developers.tron.network/docs/getting-testnet-tokens-on-tron) guide to claim Shasta TRX. Set your wallet to **Shasta**, then paste your address into the faucet. * **TRON Discord.** Join the official TRON developer Discord (linked from the guide above) and request Shasta tokens in the **faucet** channel. * **From Txn.** We can also send you test tokens directly — including `ttrx:usdt`. Contact your integration manager or email with your Shasta wallet address. {% hint style="info" %} TRC-20 transfers (including `ttrx:usdt`) consume network fees paid in TRX, so keep some `ttrx` in the wallet even when testing USDT. The Sandbox recognises a specific test USDT token (`ttrx:usdt`, contract `TG3XXyExBkPp9nzdajDZsozEu4BkaSJozs`). USDT from an unrelated test faucet may use a different contract and will not be detected — request `ttrx:usdt` from Txn if you are unsure. {% endhint %} ## 3. Make the payment 1. Create a test [invoice](/invoices/creating-invoice.md) or [channel](/channels/creating-channel.md) via the API, using `ttrx:usdt` (or `ttrx`) as the payment network. 2. Copy the receiving **address** from the response. For invoices, also note the exact **`amountCharged`** — send that amount so the invoice completes as a full payment. 3. In TronLink (on Shasta), send the token and amount to the address. 4. Within a minute or two the deposit is detected: the invoice moves through its [status flow](/invoices/invoice-status-flow.md), or the channel deposit appears in [List channel deposits](/channels/listing-channel-deposits.md). If you have configured webhooks, you also receive the corresponding events. ## Troubleshooting * **Payment not detected.** Confirm the wallet is on **Shasta** (not mainnet or Nile), that you sent the correct token to the correct address, and that you are querying the Sandbox base URL (`https://api.sandbox.txn.io`). Testnet confirmations can take a minute or two. * **Transfer fails or "out of energy".** Ensure the wallet holds some `ttrx` to cover the network fee. * **USDT sent but not credited.** Check the token contract matches the Sandbox `ttrx:usdt` token above; tokens from unofficial faucets can differ. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.txn.io/getting-setup/making-a-test-payment.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.