reseller

GET `/v1/wallet/top-ups/estimate`

What a top-up will actually credit, before you pay.

Autentifikacija

Pošaljite API ključ kao nosivi token. Ključ mora imati dozvolu billing.view; ključ bez nje se odbija s kodom 403, a ne 404.

Gdje dolazi ID vaše organizacije

Ova krajnja točka uzima org_id kao parametar upita. Izostavite ga i poziv obuhvaćett cijelo stablo vašeg najma; pošaljite ga kako biste suzili poziv na jednu organizaciju.

ID vaše organizacije nalazi se na zaslonu API ključeva u vašoj nadzornoj ploči, pored samog ključa. To je isti ID u svakom pozivu koji uputite.

Isprobajte

Zamijenite sve unutar šiljastih zagrada svojim vlastitim vrijednostima, a rezervirano mjesto za ključ s ključem iz vaše nadzorne ploče.

curl -X GET https://api.zinndigital.com/v1/wallet/top-ups/estimate?amount_minor=<amount_minor> \
  -H "Authorization: Bearer zdk_live_…"

Prijavljeni ste? API konzola na vašoj nadzornoj ploči automatski unosi stvarni ID vaše organizacije i vaš vlastiti ključ te šalje zahtjev prema aktivnom API-ju kako biste mogli vidjeti stvarni odgovor. Otvori ovu krajnju točku u API konzoli

Pojedinosti

The **pre-purchase disclosure**. Returns what we expect to put in your balance for a given amount and rail, and whether that figure can still move. ⚖️ Zinn® credits **what actually settles**, net of fees, at the real settlement rate (owner ruling 2026-08-22). On a card that is exactly the amount you asked for. On a crypto rail it can be less, because the value of the coin moves between the quote and the confirmation and the network takes a fee — so `is_estimate` is `true` and the figure is indicative. ⛔ A screen that renders `expected_credit_minor` without also reading `is_estimate` turns a disclosure into a promise. `refundable` and `expires` are both always `false` and are returned here, at the point of sale, because that is where a non-refundable purchase has to be disclosed. Requires `billing.view`.

Parametri

Naziv	Vrsta	Obavezno	Što je to
`amount_minor (query)`	`integer`	Da	The amount you want to add, in integer minor units.
`currency (query)`	`string`	Ne	ISO-4217 code. A wallet is per-currency; an unknown code is a 422.
`gateway (query)`	`string`	Ne	Which rail — `stripe`, `paypal` or `nowpayments`. Determines whether the estimate is exact or indicative; it is the crypto rail that settles at a moving rate.
`org_id (query)`	`Uuid`	Ne	Which of your organizations this applies to. Required only when you belong to more than one here — otherwise it is inferred, and an id outside your direct memberships is a 404 r…

Odgovor

Naziv	Vrsta	Obavezno	Što je to
`currency`	`string`	Da	—
`gateway`	`string`	Da	—
`quoted_minor`	`integer`	Da	What the customer asked to add.
`expected_credit_minor`	`integer`	Da	What we expect to put in their balance.
`is_estimate`	`boolean`	Da	⛔ Not decoration. `true` on a rail that settles at a moving rate (crypto), where the amount credited can be less than the amount quoted because we credit what actually settl…
`refundable`	`boolean`	Da	⚖️ Always `false` for Zinn® credit. "credit is not returnable ever, even on account closure etc." — owner, 2026-08-22. Returned at the point of sale because that is where a no…
`expires`	`boolean`	Da	⚖️ Always `false`. Credit never expires — the deliberate other half of never refundable: "you cannot have it back" is only defensible alongside "and you never lose it".

Pogreške koje ova krajnja točka može vratiti

401 · 403 · 422 · 429