Obter Cupom por Código

​

📌 Endpoint

​

🔐 Autenticação

• Rota pública.
• A loja precisa estar com plano ativo.

​

🧾 Parâmetros de rota

​

✅ 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