Webhook Subscriptions
Criar assinatura de webhook
Registra seu endpoint HTTPS para receber os tipos de evento escolhidos. O segredo de assinatura (whsec_…) é exibido uma única vez no painel — é com ele que você verifica cada entrega.
POST
Criar assinatura de webhook
Uma assinatura por URL. Depois de criar, valide a verificação de assinatura no sandbox antes de operar em produção.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Required string length:
1 - 255Body
application/json
Tipos de evento que serão entregues — assine só o que sua integração consome.
Minimum array length:
1Available options:
payment.created.v1, payment.requires_action.v1, payment.succeeded.v1, payment.failed.v1, refund.requested.v1, refund.updated.v1, refund.succeeded.v1, payout.requested.v1, payout.updated.v1, dispute.opened.v1, dispute.updated.v1, merchant.kyc.updated.v1, merchant.status.updated.v1 Endpoint HTTPS público (endereços privados são recusados).
Required string length:
8 - 2000Response
Default Response
Available options:
live, test Minimum array length:
1Available options:
payment.created.v1, payment.requires_action.v1, payment.succeeded.v1, payment.failed.v1, refund.requested.v1, refund.updated.v1, refund.succeeded.v1, payout.requested.v1, payout.updated.v1, dispute.opened.v1, dispute.updated.v1, merchant.kyc.updated.v1, merchant.status.updated.v1 Available options:
ACTIVE, DISABLED, ERROR, PENDING Maximum string length:
2000