Configurar webhook
Webhooks Config
Configurar webhook
Requer Bearer JWT. URL HTTPS + exatamente UM evento (array com 1 item) + secret opcional para assinatura HMAC. Se secret for omitido, o NTX Pay gera um automaticamente e retorna na resposta — guarde com segurança.
POST
Configurar webhook
Autorizações
JWT obtido em POST /api/auth/token
Corpo
application/json
URL HTTPS que receberá os webhooks
Exemplo:
"https://example.com/webhooks/mx"
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 elementOpções disponíveis:
cash_in, cash_out, refund_in, refund_out, internal_transfer, all Exemplo:
Secret HMAC para assinatura. Se omitido, o NTX Pay gera automaticamente.
Required string length:
8 - 128Exemplo:
"whsec_abc123"