Obtener un cupón
Obtén los detalles de un cupón específico.
Authentication
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
ID del cupón
Response
Detalles del cupón
ID único del cupón
Nombre o código del cupón
Nombre visible para el cliente (usado en modo custom_bins)
Si el descuento se aplica automáticamente en checkouts de tienda
Número máximo de usos
Número de veces que se ha redimido el descuento
Duración del descuento para suscripciones
Cuántos pagos de la suscripción llevan el descuento (solo con duration = repeating)
Compra mínima en centavos, sobre los productos a los que aplica (sin envío)
Si cada cliente puede usar el cupón una sola vez
IDs de los productos a los que aplica. Vacío si aplica a todos.
Desde cuándo se puede usar el cupón
Fecha de expiración
Estado del cupón