Cupones

Descuentos con regla de validez y límite de uso. redemptions muestra dónde se aplicó efectivamente cada cupón.

Comando	HTTP	Descripción
coupons list	GET /v1/coupons	Listar cupones
coupons create	POST /v1/coupons	Crear cupón
coupons get	GET /v1/coupons/{id}	Obtener cupón
coupons update	PATCH /v1/coupons/{id}	Actualizar cupón
coupons delete	DELETE /v1/coupons/{id}	Eliminar cupón
coupons deactivate	POST /v1/coupons/{id}/deactivate	Desactivar cupón
coupons redemptions	GET /v1/coupons/{id}/redemptions	Listar los canjes del cupón

Ejemplos

--params lleva parámetros de query y de ruta (id, página, filtros); --json lleva el cuerpo de la solicitud; --fields limita los campos que vuelven — vale la pena en todo list/get, para ahorrar contexto. Mira Flags globales para la referencia completa.

# Listar cupones
kobana billing coupons list --fields "id,public_id,external_id,code,name"

# Obtener cupón
kobana billing coupons get --params '{"id": "COUPON_ID"}'

# Crear cupón
kobana billing coupons create \
  --json '{"code": "CODE", "name": "NAME", "discount_type": "percentage", "discount_value": 0}'

# Actualizar cupón
kobana billing coupons update \
  --params '{"id": "COUPON_ID"}' \
  --json '{"name": "NAME", "external_id": "EXTERNAL_ID", "description": "DESCRIPTION"}'

# Desactivar cupón
kobana billing coupons deactivate --params '{"id": "COUPON_ID"}'

# Eliminar cupón
kobana billing coupons delete --params '{"id": "COUPON_ID"}' --dry-run

Próximos pasos

• Clientes
• Introspección de schema — todos los parámetros que este recurso acepta.