Skip to navigation

Crear un paquete de sesiones

Pone a la venta sesiones por adelantado: un producto en la tienda, en la moneda de la cuenta, que al pagarse le da al cliente credits sesiones para los servicios de service_ids, válidas expires_in_months meses (sin vencimiento si no lo envías). Una cita de esos servicios gasta una sesión en vez de cobrar, salvo en un servicio que pide anticipo.

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.

Request

This endpoint expects an object.
namestringRequired
amount_in_centsintegerRequired
creditsintegerRequired1-100
service_idslist of stringsRequired
expires_in_monthsinteger or nullOptional1-36

Response

Paquete a la venta
idstringOptional
product_idstringOptional
El producto con que se vende en la tienda.
namestringOptional
amount_in_centsinteger or nullOptional
currencystring or nullOptional
creditsintegerOptional
Sesiones que da.
expires_in_monthsinteger or nullOptional

Meses que valen las sesiones desde la compra; null si no vencen.

service_idslist of stringsOptional
Los servicios que paga.
on_salebooleanOptional

false cuando dejó de venderse; las sesiones vendidas siguen valiendo.

created_atdatetimeOptional

Errors

400
Bad Request Error
422
Unprocessable Entity Error