Skip to main content

Currency

Every account has exactly one currency, USD or IDR. It is chosen when your account is created and cannot be changed afterwards. All monetary values (balance, price_per_order, amount, required) are in that currency, and every response that contains money also contains a currency field. Amounts are JSON numbers, not strings. Do not hard-code a currency symbol: read currency from the response.
Examples in this documentation use USD. Your real currency is set on your account and is returned as currency in every response.

Credit and pricing

You top up a credit balance in your account currency. Each order costs your agreed price per order, deducted when the order is accepted.
  • If an email address is rejected by validation (invalid, mailbox full, disposable, etc.) the request fails with 422, no order is created and no credit is charged.
  • If we cannot process an order for an internal reason (503), no credit is charged either.
  • If your balance is too low, the request fails with 402.