Complete the guided test order
Place one Sandbox order from the dashboard, step by step, and see every part of an order before you write code.
Sandbox: test money only. No request moves real money.
In this step you place one Sandbox order from the dashboard. It walks you through every part of an order: the product, the recipient, the price, the order and its outcome. Nothing reaches Telegram and the money is test funds.
The dashboard sends the same request your own code sends in the next step, so what you see here is what your integration will see.
Place the guided order
- In your setup checklist, choose the guided test order.
- Choose Telegram Stars or Telegram Premium, and how much.
- Enter a Telegram username.
nasfam_test_okis a test recipient that is always delivered. - Check the account found, if you want to. It is optional, and the order checks the recipient itself.
- Review the price, every fee included, before you send.
- Send it, then watch the order move from
processingtosucceeded.
When the step is done
The step is done when the order reaches succeeded. An order that was accepted and is still processing is not done yet, and a failed order never counts: send another.
This step counts orders placed in the dashboard only. The next step counts an order your own code sends with your key, so each one shows a different part of your setup working.
Try the other test recipients too: nasfam_test_rejected fails, nasfam_test_slow takes about two minutes. Sandbox scenarios lists every one.
Read it from your code
Every order has an id. Copy it from the order in the dashboard and read it with your Sandbox key: the answer is the same order, with the same status and version.
// npm install axiosimport axios from 'axios';try { const { status, data: order } = await axios. get( 'https:// sandbox-api. nasfampay. com/ v1/ orders/ ord_ 01K7SAMP000000000000000090', { headers: { Authorization: `Bearer ${process. env. NASFAM_ SANDBOX_ KEY}`, }, }, ); console. log( status, order);} catch ( error) { if ( !axios. isAxiosError( error) || !error. response) throw error; const problem = error. response. data; throw new Error( `${problem. status} ${problem. code}: ${problem. title} ( request ${problem. request_ id})`);}What you should see
The order reads succeeded, and your setup checklist shows the step as done. The dashboard sent this body and received this answer:
{ "id": "ord_ 01K7SAMP000000000000000093", "environment": "sandbox", "status": "processing", "status_ reason": null, "product": "telegram_ stars", "selection": { "quantity": 50 }, "recipient": { "telegram_ username": "nasfam_ test_ ok" }, "amount": { "amount": 75, "currency": "USD" }, "quote_ id": null, "pricing_ version": "sandbox-synthetic-v1", "reference": null, "version": 1, "estimated_ completion_ at": "2026-10-10T10:15:05.000Z", "created_ at": "2026-10-10T10:15:02.000Z", "updated_ at": "2026-10-10T10:15:02.000Z", "completed_ at": null}If it fails
| What you see | What to check |
|---|---|
| The order is refused for lack of funds | Add test funds first; see step 1. Nothing was held. |
| The step stays undone after the order was accepted | The order is still processing. Wait for succeeded; never place a second order to find out. |
| The order failed | Read its reason in the dashboard. A nasfam_test_rejected recipient always fails. Place another order to nasfam_test_ok. |
recipient_not_found | Nobody has this username. Use nasfam_test_ok in the Sandbox. |
not_found | Reading the order from your code: check the id, and that the key belongs to the workspace that placed it. |
Next step
Sandbox step 5 of 7: Send your own API order. One request that creates a sandbox order for Telegram Stars or Premium, then the order read back by its id.
Related concepts
- Orders and statuses: every status, and where your money is in each.
- Sandbox scenarios: the test recipients and what each does.
- Get an order: every field of an order.
