Guides / Integration guides

Balance & funding

Giftronaut uses a prepaid balance model. Top up your account before placing orders — every successful order deducts the order amount from your balance in real time.

Step 1 — Add funds to your account

Before you can place any orders, your account must have sufficient balance. To add funds, log into the Giftronaut portal and click Add Funds. Only USD is supported.

Two payment methods are available:

Payment method	Typical timeline	Fee
Credit card	~10 minutes (standard business hours)	3% processing fee
ACH transfer	2–5 business days	No fee
Wire transfer	1–2 business days	No fee

Once your deposit is submitted, it will appear as Pending in your balance until payment is received and posted. You'll get an email notification when funds become available.

Checks are not accepted. Any checks received will be securely shredded. Please use ACH/Wire or credit card instead.

Credit card deposits may require additional verification. In rare cases, processing can take up to 2 business days.

How to fund your account

Step 2 — Check your balance

You can check your available balance at any time via the API:

curl "https://api.giftronaut.com/api/v1/balance" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "data": {
    "availableBalance": { "amount": 4700.00, "currency": "USD" },
    "pendingBalance": { "amount": 150.00, "currency": "USD" }
  }
}

availableBalance.amount is the amount you can spend right now — your total balance minus any pending order deductions.

How balance works

When an order is successfully placed, the order amount is deducted from your available balance.
If the order is cancelled before its scheduled delivery, the deducted amount is refunded to your available balance.

Insufficient balance

If your available balance is lower than the total order cost, the API returns:

{
  "error": "INSUFFICIENT_BALANCE",
  "message": "Account balance is insufficient for this order"
}

Top up your account through the Giftronaut portal before retrying the order.