Two payments, two relationships
Your customer pays your business through your payment provider. Separately, your business prepays Akariq for eSIM purchases. Akariq does not charge your consumer on reseller orders.
The wallet is prepaid account credit. It is not a credit line, postpaid billing or permission to overdraw the account.
You can manage funding and view transaction history in the partner dashboard, without writing API calls. See dashboard access for credentials and permissions.
Add funds
Call POST /balance/topups with amountCents and an Idempotency-Key. The supported funding amount is USD 10–1,000 per request. Complete payment at the returned Stripe checkout URL.
Credit becomes available only after Akariq verifies successful payment. A redirect from checkout is not proof of credit. Check GET /balance or the billing page before spending. Retrying a funding request uses the same key and body; it must not create a second payment.
Available and reserved credit
| Balance | Meaning |
|---|---|
availableCents | Credit available for new purchases |
reservedCents | Credit held for accepted orders still being processed |
lowBalance | Whether available funds are at or below your configured threshold |
For example, with USD 10 available, accepting a USD 1.03 order leaves USD 8.97 available and USD 1.03 reserved. When fulfillment succeeds, that reservation is settled and reserved credit returns to zero. The USD 8.97 available balance remains unchanged.
A confirmed failed purchase releases its reservation. An uncertain supplier outcome keeps the funds reserved while Akariq investigates. A timeout does not prove that no eSIM was issued.
Keep your own ledger in sync
Use GET /balance/transactions to retrieve credits, reservations, settlements and releases. Store the transaction ID and follow nextCursor when paginating. Reconcile these records with your orders and funding payments.
An earlier balance check does not reserve funds. Concurrent orders can consume available credit; handle 409 insufficient_balance even if a preceding balance check succeeded.
Refunds and funding disputes
Consumer refunds through your payment provider do not automatically refund an Akariq purchase. Contact Akariq about supplier or fulfillment issues. Unused-credit refunds require an operator review; there is no public withdrawal or refund endpoint.
Funding reversals or disputes can suspend purchasing while the account is reconciled. If reversed credit has already been spent, the account can show a deficit and requires resolution before further orders. Agree refund and commercial terms during onboarding.
Automatic wallet top-ups and postpaid purchasing are not currently available.