Guides / Integration guides

Balance & funding

Giftronaut uses a prepaid balance, and each successful order is deducted from the available balance in real time. Top up your account before placing orders.

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.

Wire transfers typically take 1–2 business days to become available, while ACH transfers take 2–5 business days, starting from the date the customer's bank sends the payment. Credit card deposits are typically available within about 10 minutes during business hours, and in rare cases up to 2 business days. Log into the Giftronaut portal to make a deposit, or request an ACH top-up via the API.

Giftronaut charges a 3% processing fee on credit card deposits and no fee on ACH or wire deposits. Rewards cost face value; credit card funding carries a 3% fee, while ACH and wire transfers are free. The Giftronaut API accepts ACH top-up requests of $100 or more through POST /api/v1/balance/charge.

Three 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

Giftronaut returns both your available and pending balance from GET /api/v1/balance:

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.
Giftronaut converts non-USD Branded Card amounts to USD and deducts the USD total from your balance.
If the order is cancelled before its scheduled delivery, the deducted amount is refunded to your available balance.

Insufficient balance

Giftronaut rejects an order that the available balance cannot cover; the order is not queued. If your available balance is lower than the total order cost, the API returns:

{
  "code": "INSUFFICIENT_BALANCE",
  "message": "Account balance is insufficient for this order",
  "details": null
}

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