Create an order
Orders one or more eSIMs. Returns one topup_id per unit; the eSIM data for each arrives on your webhook as esim.issued.
Safe to retry: sending the same external_order_id again returns the original order instead of placing a new one.
201 lists one topup_id per unit; each eSIM’s
activation data then arrives on your webhook as
esim.issued.
Retrying an order
external_order_id is your idempotency key. Sending an order again with the
same external_order_id returns the original order rather than placing a new
one, so when a request times out or answers 5xx or a provider 422, retry it
as it was.
- Keep the same
external_order_idand products on a retry. - Use a new
external_order_idonly for a genuinely new order. - Another partner using the same value does not affect you: it is unique within your account only.
Errors
external_order_id must be 1-64 characters of letters, digits, '-' or '_'products must be a non-empty arrayproducts[N] must be an objectproducts[N].qty must be a positive integerproducts[N].option_id is not a known product
Authorizations
Lowercase hex HMAC-SHA256 over the five-line string {METHOD}\n{REQUEST_PATH}\n{TIMESTAMP}\n{ACCESS_KEY}\n{BODY_SHA256}, keyed with your Base64-decoded secret key.
REQUEST_PATH includes the /api prefix and excludes the domain and any query string. BODY_SHA256 is the lowercase hex SHA-256 of the exact body bytes you send; for a request with no body, hash the empty string. The string always has five lines.