Sign inGet Started
Comenzar
Guías
Referencia de API
SDKs
CLI
Base de conocimientos
Registro de cambios

Get eSIM checkout options

GET
/v1/esim/offers/{offer_id}/checkout
bird esim offers checkout-options <offer-id>
Respuesta200
{
  "offer_id": "eof_01krdgeqcxet5s7t44vh8rt9mg",
  "one_time": {
    "price": {
      "amount": "0.00995",
      "currency_code": "USD"
    }
  },
  "recurrence": {
    "available": true,
    "quote": {
      "delivery_mode": "exact_period",
      "price": {
        "amount": "0.00995",
        "currency_code": "USD"
      },
      "model": "calendar_month"
    }
  }
}

Returns published one-time terms and automatic renewal availability for a new eSIM. Automatic renewal includes its own price and cadence when an eligible mobile network is available. Availability is checked again when purchasing; this read does not reserve a package.

Parámetros

offer_idstring

The offer.

Carga de respuesta

offer_id
string
obligatorio
one_time
object
obligatorio

Published one-time purchase terms before tax.

Mostrar atributos secundarios
recurrence
object
obligatorio

When available is true, quote contains the recurring terms and unavailable_reason is null. Otherwise quote is null and unavailable_reason explains why renewal is unavailable.

Mostrar atributos secundarios
recurrence.available
boolean
obligatorio

Whether automatic renewal is currently available for a new eSIM.

recurrence.quote
nullable object
obligatorio
Mostrar atributos secundarios
recurrence.quote.delivery_mode
string
obligatorio

Relationship between the paid period and package delivery.

  • exact_period: the package covers the accepted paid interval.
  • recurring_top_up: each funded period purchases a standard package. Activation, expiry, and accumulation follow that package’s terms.

Possible values: exact_period, recurring_top_up

recurrence.quote.offer_revision
integer
obligatorio

The offer revision to accept when purchasing.

recurrence.quote.recurrence_revision
integer
obligatorio

The recurring configuration revision to accept when purchasing.

recurrence.quote.price
object
obligatorio
Mostrar atributos secundarios
recurrence.quote.price.amount
string
obligatorio

Decimal amount as a string, in major currency units.

recurrence.quote.price.currency_code
string
obligatorio

ISO 4217 currency code.

recurrence.quote.model
string
obligatorio

Billing cadence for recurring packages.

  • calendar_month: periods follow calendar months from the billing anchor.
  • fixed_days: each period lasts the stated number of 24-hour days.

Possible values: calendar_month, fixed_days

recurrence.quote.interval_count
integer
obligatorio

The number of calendar months or fixed 24-hour days per period.

recurrence.unavailable_reason
nullable string
obligatorio

Recursos relacionados

Continúa con la documentación, guías y ejemplos de este tema.

Obtener un resumen de implementación