Configurar webhook de la cuenta
Configura o actualiza la URL del webhook para un tipo de evento específico. Si ya existe un webhook para el mismo tipo de evento, se actualizará (comportamiento upsert).
Requiere un Bearer token en el header Authorization.
Evento Descripción cash_inPIX recibido cash_outPIX enviado refund_inReembolso de pago recibido (reembolso solicitado) refund_outReembolso recibido
Campo Tipo Requerido Descripción urlstring Sí URL HTTPS del endpoint que recibirá los webhooks eventTypestring Sí Tipo de evento: cash_in, cash_out, refund_in, refund_out headersarray No Headers personalizados para autenticación (máximo 5). Headers bloqueados: host, content-length, connection, transfer-encoding, content-type, user-agent headers[].keystring Sí Nombre del header headers[].valuestring Sí Valor del header
{ "url" : "https://api.example.com/webhooks/pix" , "eventType" : "cash_in" , "headers" : [ { "key" : "Authorization" , "value" : "Bearer token123" }, { "key" : "X-Webhook-Secret" , "value" : "abc123" } ] } Campo Tipo Descripción successboolean Indica si la operación fue exitosa messagestring Mensaje descriptivo del resultado
{ "success" : true , "message" : "Webhook configurado com sucesso" } Estado Descripción 400 Datos inválidos (la URL no es HTTPS, tipo de evento inválido, etc.) 401 Token faltante o inválido 404 Cuenta no encontrada 500 Error interno al configurar el webhook
