Endpoint: POST /event/seller/{account_id}/events/{events_pk}/coupons/
Autenticação: JWT obrigatório ou Chave de API aceita.
Cria um cupom de desconto vinculado ao evento. A API verifica se o evento pertence ao {account_id} antes de persistir (devolve 400 caso contrário). O código é normalizado para maiúsculas e é rejeitado quando contém espaços ou quando colide com um cupom já existente no mesmo evento.

​
Pré-requisitos

  • O evento precisa existir e pertencer ao {account_id}.
  • code precisa ser único dentro do evento.
  • value > 0. Para cupons PERCENTAGE, value <= 100.

​
Parâmetros de path

​
account_id
string (uuid)
required
​
events_pk
string (uuid)
required

​
Corpo da requisição

​
name
string
required
Rótulo de exibição. Até 100 caracteres.
​
code
string
required
Até 50 caracteres. Normalizado para maiúsculas; espaços são rejeitados.
​
type
string
required
FIXED ou PERCENTAGE.
​
value
integer
required
Valor do desconto. Para FIXED, em centavos de BRL. Para PERCENTAGE, inteiro de 1 a 100.

​
Resposta

201 Created com o cupom persistido. 
{
  "id": "ccccdddd-eeee-ffff-0000-111122223333",
  "name": "Lançamento 10%",
  "code": "SUNSET10",
  "type": "PERCENTAGE",
  "value": 10,
  "created_at": "2026-05-01T12:00:00Z",
  "updated_at": "2026-05-01T12:00:00Z"
}

​
Erros

StatusQuando
400Código com espaços, código duplicado no evento, value <= 0, percentual maior que 100 ou evento não encontrado/não pertence à conta.
401Token ausente ou inválido.

​
Exemplos

curl -X POST "https://api.dlpay.cloud/event/seller/$ACCOUNT_ID/events/$EVENT_ID/coupons/" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Lançamento 10%", "code": "SUNSET10", "type": "PERCENTAGE", "value": 10}'