eSIM pricing
What each eSIM price field means and the 12% agency commission formula.
Every eSIM package and topup package exposes the same set of agency-facing money fields, computed server-side in your agency's currency. Any pricing sent in a request body is ignored.
Field meanings
| Field | Meaning |
|---|---|
price | FX-Port's B2B price for this package, in your agency currency |
retail_price / total_price | price + your 12% agency commission — what you charge the traveler |
balance_debit_amount | The amount debited from your agency balance when you order or top up |
agency_commission | Text field showing the commission rate applied ("12 %", or "0 %" for corporate/contracted agencies) |
currency | Your agency's settlement currency |
supplier_currency | The currency the fulfilling eSIM supplier settles in (e.g. "USD") |
exchange_rate | supplier_currency → currency rate used to compute the above |
The formula
retail_price = price + (price × 12%)Example (Euro, EUR, supplier settling in USD):
{
"price": 8.50,
"retail_price": 9.52,
"total_price": 9.52,
"balance_debit_amount": 8.50,
"agency_commission": "12 %",
"currency": "EUR",
"supplier_currency": "USD",
"exchange_rate": 0.92
}Check: 8.50 × 1.12 = 9.52 ✓
Corporate / contracted agencies are charged 0% commission instead of 12% — agency_commission
reflects the rate that actually applies to your account.
Supplier currency
FX-Port sources eSIM packages from multiple suppliers, and each supplier settles in its own
currency (configured per supplier on the FX-Port side — not hard-coded). exchange_rate is always
supplier_currency → currency, never assumed to be USD. If a package's supplier_currency already
matches your agency currency, exchange_rate is 1.0.
Order and topup responses
POST /api/v1/esims/orders and POST /api/v1/esims/topups return the same pricing shape nested
under data.order / data.topup as price, net_price, total_price, currency,
agency_currency, supplier_currency, and exchange_rate, plus a balance block on topups
showing previous and current agency balance.