Saltar al contenido principal
GET
Get coupon by code

📌 Endpoint

GET /stores/{storeId}/coupons/{code} Busca un cupón por el código para uso en checkout.

🔐 Autenticación

  • Ruta pública.
  • La tienda necesita tener plan activo.

🧾 Parámetros de ruta


🔎 Parámetros de consulta


✅ Ejemplo de solicitud


📦 Respuesta exitosa (200)


⚠️ Posibles errores

  • 400 INVALID_DATA → parámetros inválidos
  • 400 COUPON_EXPIRED → cupón expirado
  • 400 COUPON_ALREADY_USED → límite de uso alcanzado o el cliente (email/cpf) ya usó el cupón con SINGLE_USE_PER_CUSTOMER
  • 401 UNAUTHENTICATED → no autenticado
  • 403 NO_ACTIVE_SUBSCRIPTION → plan inactivo/expirado
  • 404 STORE_NOT_FOUND → tienda no encontrada
  • 404 COUPON_NOT_FOUND → cupón inexistente
  • 429 RATE_LIMIT_EXCEEDED → límite de solicitudes por minuto excedido
  • 500 INTERNAL_SERVER_ERROR → error interno del servidor
  • 503 SERVICE_UNAVAILABLE → servicio no disponible

Parámetros de ruta

storeId
string
requerido
Required string length: 1 - 50
code
string
requerido
Required string length: 1 - 32

Parámetros de consulta

email
string<email>

Optional buyer email to validate single-use-per-customer coupons.

cpf
string

Optional buyer CPF to validate single-use-per-customer coupons.

Respuesta

Get coupon by code.

code
string
requerido
Ejemplo:

"SUCCESS"

coupon
object
requerido

Store discount coupon.