Obtener una cuenta abierta

GET

https://app.recurrente.com/api/service_tabs/:id

GET

/api/service_tabs/:id

curl https://app.recurrente.com/api/service_tabs/id \
     -H "X-SECRET-KEY: <apiKey>"

200Retrieved

{
  "id": "st_du7dnfwt",
  "status": "open",
  "display_name": "Mesa 4",
  "phone": "+50255551234",
  "customer_id": "cus_3jfrywsf",
  "currency": "GTQ",
  "total_in_cents": 12500,
  "payment_strategy": "card_on_file",
  "opening_commitment": "products",
  "items": [
    {
      "id": "it_eyJfcmFpbHMiOnsi",
      "price_id": "price_hguxwfto",
      "name": "Cerveza",
      "quantity": 2,
      "amount_in_cents": 5000,
      "currency": "GTQ"
    }
  ],
  "authorized_amount_in_cents": 0,
  "authorization_expires_at": "2024-01-15T09:30:00Z",
  "checkout_url": "https://app.recurrente.com/checkout-session/ch_ccydxmvm8fvhmxsn",
  "opened_at": "2024-01-15T09:30:00Z",
  "closed_at": "2024-01-15T09:30:00Z",
  "created_at": "2024-01-15T09:30:00Z"
}

Obtén una cuenta abierta con sus items vigentes y su total actual.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Path parameters

idstringRequired

ID de la cuenta abierta

Response

Detalles de la cuenta abierta

idstringOptional

ID de la cuenta abierta

statusenumOptional

Estado de la cuenta. open acepta items; closing ya está cerrada y espera el pago; paid se cobró; voided se anuló sin cobrar; abandoned se dejó vencer.

Allowed values:

display_namestringOptional

Nombre con el que el comercio identifica la cuenta (mesa, cliente, cuarto)

phonestring or nullOptional

Teléfono del cliente al momento de abrir la cuenta

customer_idstringOptional

ID del cliente dueño de la cuenta

currencystringOptional

Moneda de la cuenta

total_in_centsintegerOptional

Total consumido hasta ahora, en centavos

payment_strategyenumOptional

card_on_file cobra al cerrar la tarjeta guardada del cliente. preauthorization mantiene un hold del monto estimado y solo se puede activar desde el dashboard, porque requiere una autorización real del procesador.

Allowed values:

opening_commitmentenumOptional

Qué se comprometió al abrir la cuenta. Se infiere de la solicitud: products si mandaste items, manual_amount si mandaste estimated_amount, none si no mandaste ninguno.

Allowed values:

itemslist of objectsOptional

Líneas vigentes de la cuenta (los items anulados no aparecen)

authorized_amount_in_centsintegerOptional

Monto preautorizado con hold sobre la tarjeta, en centavos. 0 cuando no hay preautorización.

authorization_expires_atdatetime or nullOptional

Momento en que expira el hold de la preautorización

checkout_urlstring or nullOptional

Checkout que cierra la cuenta; pagarlo la marca como paid. Solo aparece mientras la cuenta se está cobrando (closing o paid): si un cobro con tarjeta se declina, la cuenta se reabre y el checkout de ese intento no se publica, porque el cliente no podría pagarlo.

opened_atdatetimeOptional

Momento en que se abrió la cuenta

closed_atdatetime or nullOptional

Momento en que se cerró la cuenta

created_atdatetimeOptional