Cupons
Criar Cupom
Aprenda a criar cupons usando o endpoint POST /stores//coupons.
POST
Create coupon
Endpoint
POST /stores/{storeId}/coupons
Cria um novo cupom para produtos e/ou categorias.
Autenticação
- Rota privada.
- Requer header
Authorizationcom sua API key e plano ativo.
Parâmetros de rota
Body (JSON)
É necessário enviar ao menos um entre
productIds e categoryIds.
Exemplo de requisição
Snippet padrão (cURL)
Use o exemplo cURL da seção Exemplo de requisição acima como snippet oficial.Resposta de sucesso (201)
Possíveis erros
400 INVALID_DATA-> body inválido400 INVALID_DATA_CODE->codeausente ou fora de 3 a 32 caracteres400 INVALID_DATA_DISCOUNT->discountausente ou fora de 1 a 100400 INVALID_DATA_USE_LIMIT->useLimitfora de -1 a 9999400 INVALID_DATA_RULES->rulesinválido ou regra malformada400 INVALID_DATA_EXPIRED_AT->expiredAtinválido ou não está no futuro400 INVALID_DATA_SCOPE_REQUIRED-> nenhum entreproductIdsecategoryIdsfoi enviado400 RELATION_NOT_FOUND-> produto/categoria inválido401 API_KEY_NOT_PROVIDED-> headerAuthorizationnão enviado401 INVALID_API_KEY-> API key inválida401 UNAUTHENTICATED-> usuário não autenticado403 USER_DISABLED-> usuário desativado403 NO_ACTIVE_SUBSCRIPTION-> sem plano ativo403 COUPON_LIMIT_REACHED-> limite de cupons do plano atingido404 STORE_NOT_FOUND-> loja não encontrada409 COUPON_ALREADY_EXISTS-> código já existente429 RATE_LIMIT_EXCEEDED-> limite de requisições por minuto excedido500 INTERNAL_SERVER_ERROR-> erro interno503 SERVICE_UNAVAILABLE-> serviço indisponível
Corpo
application/json
Coupon details (code, discount, expiration).