Skip to main content

​
📌 Endpoint

GET /stores/:storeId/coupons/:code Busca um cupom pelo código para uso em checkout.

​
🔐 Autenticação

  • Rota pública.
  • Possui rate limit de 3 tentativas por minuto.
  • A loja precisa estar com plano ativo.

​
🧾 Parâmetros de rota

ParâmetroTipoObrigatórioDescrição
storeIdstringSimID da loja
codestringSimCódigo do cupom

​
✅ Exemplo de requisição

curl -X GET "https://api.cabrapi.com.br/stores/STORE_ID/coupons/BEMVINDO10"

​
📦 Resposta de sucesso (200)

{
	"status": true,
	"code": "SUCCESS",
	"coupon": {
		"id": "COUPON_ID",
		"code": "bemvindo10",
		"discount": 10,
		"useLimit": -1,
		"expiredAt": null,
		"products": [
			{ "id": "PRODUCT_ID", "name": "Curso Premium" }
		],
		"categories": []
	}
}

​
⚠️ Possíveis erros

  • 400 INVALID_DATA → parâmetros inválidos
  • 400 COUPON_EXPIRED → cupom expirado
  • 400 COUPON_ALREADY_USED → limite de uso atingido
  • 404 STORE_NOT_FOUND → loja não encontrada
  • 404 COUPON_NOT_FOUND → cupom inexistente
  • 403 NO_ACTIVE_SUBSCRIPTION (ou similar) → plano inativo/expirado
  • 500 INTERNAL_SERVER_ERROR → erro interno