x402sms
Concepts

Pricing

How activation prices work, and the minimum charge.

Simple rules

  • Every activation has a dynamic price that depends on the service and country you pick
  • Minimum charge: $0.50 per activation
  • You always see the exact price before paying — either via the quote endpoint or in the 402 payment requirements themselves
  • With pay on success, the price you see is the maximum you authorize — you are charged only when the SMS code arrives

Quotes

GET /v1/price?service=ALIAS&country=ID returns the current price without payment:

{
  "service": "tg",
  "country": 16,
  "priceUsd": 1.941139,
  "priceAtomic": "1941139"
}

priceAtomic is USDC with 6 decimals — the exact amount you will see in the 402 payment requirements.

Price changes

Prices can drift over time (inventory, demand, exchange rates). A quote is a snapshot, not a guarantee — the 402 response at order time is always the source of truth. You will never be charged more than the amount shown in the payment requirements you accepted.

On this page