Skip to main content
POST
URL: POST https://api.goatpay.com.br/v1/coupons/create · Permissão: coupons/create

Corpo

string
required
Código (até 32 caracteres, único na conta).
string
required
PERCENT ou FIXED.
number
required
Percentual ou valor fixo em BRL.
number
Limite de usos.
string
ISO 8601.
array
Restringe a produtos.
Restringe a links.
Guia: Cupons.

Authorizations

X-API-Key
string
header
required

Chave gp_live_... criada em Integrações → Chaves de API no dashboard.

Body

application/json
code
string
required
Maximum string length: 32
discountType
enum<string>
required
Available options:
PERCENT,
FIXED
discountValue
number
required
Required range: x >= 0.01
maxUses
integer
Required range: x >= 1
expiresAt
string<date-time>
productIds
string[]

Response

200 - application/json

Cupom criado, consultado ou atualizado.

success
boolean
required
message
string
required
data
object
required
requestId
string