Skip to content

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

  1. In your setup checklist, choose the guided test order.
  2. Choose Telegram Stars or Telegram Premium, and how much.
  3. Enter a Telegram username. nasfam_test_ok is a test recipient that is always delivered.
  4. Check the account found, if you want to. It is optional, and the order checks the recipient itself.
  5. Review the price, every fee included, before you send.
  6. Send it, then watch the order move from processing to succeeded.

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.

Code for Read it from your code
GET /v1/orders/{id}Sandbox, test key
// 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:

Code for What you should see
The order the dashboard placed
JSON
202 AcceptedSynthetic sandbox data
{  "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 seeWhat to check
The order is refused for lack of fundsAdd test funds first; see step 1. Nothing was held.
The step stays undone after the order was acceptedThe order is still processing. Wait for succeeded; never place a second order to find out.
The order failedRead its reason in the dashboard. A nasfam_test_rejected recipient always fails. Place another order to nasfam_test_ok.
recipient_not_foundNobody has this username. Use nasfam_test_ok in the Sandbox.
not_foundReading 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.