Enviar webhook de teste

curl --request POST \ --url https://sandbox.mx.ntxpay.com/api/webhooks-config/test \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "status": "LIQUIDATED", "overrideUrl": "<string>", "amountCentavos": 1000 } '

{ "delivered": true, "url": "<string>", "eventId": "<string>", "status": "<string>", "signed": true, "statusCode": 123, "timeMs": 123, "signatureHeader": "<string>", "payloadSent": {}, "merchantResponse": "<unknown>" }

Authorizations

Authorization

string

header

required

JWT obtido em POST /api/auth/token

Body

application/json

eventType

enum<string>

required

Evento a simular (qual webhook recebe).

Available options:

cash_in,

cash_out,

refund_in,

refund_out,

internal_transfer

status

enum<string>

default:LIQUIDATED

Status no payload. REJECTED/RETURNED simulam estados de ERRO.

Available options:

LIQUIDATED,

PENDING,

REJECTED,

RETURNED

overrideUrl

string

URL temporária de teste (ex.: webhook.site). Se omitida, entrega na URL configurada. A assinatura usa o secret do webhook configurado.

amountCentavos

integer

default:1000

Valor em centavos (default 1000 = $10).

Required range: x >= 1

Response

Resultado da entrega (delivered, statusCode, payloadSent, assinatura).

delivered

boolean

true = o endpoint do integrador respondeu 2xx.

url

string

URL para onde o webhook de teste foi enviado.

eventId

string

ID do evento (header x-event-id) — use para idempotência.

status

string

signed

boolean

true = payload assinado (X-NTXPay-Signature).

statusCode

integer

Status HTTP que o endpoint do integrador respondeu (0 = erro de conexão).

timeMs

integer

signatureHeader

string | null

Header X-NTXPay-Signature enviado (sha256=).

payloadSent

object

Payload enviado — compare com o que seu endpoint recebeu.

merchantResponse

any | null

Trecho da resposta do seu endpoint.