Skip to content

Add test funds

Credit your Sandbox balance with test money, so your test orders have something to spend.

Sandbox: test money only. No request moves real money.

In this step you add test funds to your Sandbox workspace. Test funds have no real value, cannot be withdrawn and exist only in the Sandbox. Every order is paid from your available balance, so this comes before your first order.

You need a Sandbox account and a workspace. If you have neither yet, create your account first.

Add test funds in the dashboard

  1. Sign in to your Sandbox dashboard, in your workspace.
  2. Open Balance and press Add test funds, or press it on the step in your setup checklist.
  3. Confirm the amount. The dialog shows how much it adds and the most a Sandbox balance can hold.

Add test funds now, before your first order. An order sent with nothing available is refused with insufficient_funds, and nothing is held.

An Owner, an Admin or a Developer can add test funds. A Finance or Viewer member sees the balance but cannot add to it.

What test funds are

Test funds are synthetic USD. They pay for Sandbox orders only, which are simulated: nothing reaches Telegram. They are never real money, never reach Live, and Live has no button that adds them.

Each credit is a funding on your statement, like a real one, so you can practise reconciling it. Read the currency of every amount, and never assume it.

Check the balance from your code

Once you have a key, in the next step, GET /balance shows the credit in available. The example reads the key from NASFAM_SANDBOX_KEY.

Funding by API is a simulated deposit; see Funding with GRAM.

Code for Check the balance from your code
GET /v1/balanceSandbox, test key
// npm install axiosimport axios from 'axios';try {  const { status, data: balance } = await axios.get(    'https://sandbox-api.nasfampay.com/v1/balance',    {      headers: {        Authorization: `Bearer ${process.env.NASFAM_SANDBOX_KEY}`,      },    },  );  console.log(status, balance);} 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 dashboard shows the step as done, and your balance shows the credit as available. Read with your key, GET /balance answers like this:

Code for What you should see
A Sandbox balance with test funds
JSON
200 OKSynthetic sandbox data
{  "available": {    "amount": 10000,    "currency": "USD"  },  "held": {    "amount": 0,    "currency": "USD"  },  "pending_funding": {    "amount": 0,    "currency": "USD"  },  "updated_at": "2026-10-10T10:15:00.000Z"}

If it fails

What you seeWhat to check
There is no Add test funds buttonYou are in Live, or your role is Finance or Viewer. Test funds exist only in the Sandbox, for an Owner, an Admin or a Developer.
The dialog says your balance is fullYour available balance is already at the most a Sandbox balance can hold. Spend some on test orders first.
The dialog asks you to waitYou added test funds several times in a short while. Wait the time it shows, then try again.
GET /balance shows nothing availableRead available, not held, and check the key is the Sandbox key of the same workspace you funded.
insufficient_scopeThe key cannot read the balance. Reading it needs balance:read; you choose what a key may do when you create it.

Next step

Sandbox step 2 of 7: Create a Sandbox API key. Create a sandbox key, keep it safe, and be sure the sandbox is where your requests go.