Skip to main content
POST
Configurar webhook

Autorizaciones

Authorization
string
header
requerido

JWT obtido em POST /api/auth/token

Cuerpo

application/json
url
string<uri>
requerido

URL HTTPS que receberá os webhooks

Ejemplo:

"https://example.com/webhooks/mx"

events
enum<string>[]
requerido

Um webhook assina exatamente UM evento. O campo é um array por compatibilidade de contrato, mas deve conter um único item. Use all (Geral) para receber todos os eventos em uma única URL.

Required array length: 1 element
Opciones disponibles:
cash_in,
cash_out,
refund_in,
refund_out,
internal_transfer,
all
Ejemplo:
secret
string

Secret HMAC para assinatura. Se omitido, o NTX Pay gera automaticamente.

Required string length: 8 - 128
Ejemplo:

"whsec_abc123"

Respuesta

Webhook configurado

id
integer
Ejemplo:

42

url
string
Ejemplo:

"https://example.com/webhooks/mx"

events
string[]
Ejemplo:
isActive
boolean
Ejemplo:

true

secret
string

Secret gerado pelo NTX Pay — exibido apenas na criação. Guarde com segurança.

Ejemplo:

"whsec_abc123"