Webhook: payment.operator_required

POST

Aviso de evento firmado. Verifica la firma antes de actualizar tu sistema.

Parámetros

Parámetros de cabecera

webhook-id

obligatorio

string

Identificador de mensaje de Standard Webhooks. Coincide con el id del evento en el cuerpo y es la clave de idempotencia del consumidor.

webhook-timestamp

obligatorio

string

/^[0-9]+$/

Segundos Unix en que se firmó la entrega. Rechaza una marca de tiempo fuera de una tolerancia de cinco minutos.

webhook-signature

obligatorio

string

/^v1,[A-Za-z0-9+/=]+( v1,[A-Za-z0-9+/=]+)*$/

Lista separada por espacios de firmas HMAC-SHA256 v1, sobre ... Acepta la entrega cuando coincide cualquier entrada.

Cuerpo de la solicitud^obligatorio

Media typeapplication/json

Evento firmado que se entrega cuando la auditoría de liquidación de un pago aprobado necesita al equipo de Timbro. Consulta el pago para obtener su código de problema; la aprobación sigue vigente.

object

id

obligatorio

Identificador del evento, igual al encabezado webhook-id.

string

/^event_[0-9a-hjkmnp-tv-z]{24,}$/

type

obligatorio

string

Valor permitido: payment.operator_required

apiVersion

obligatorio

Identidad del contrato vigente con la que se generó este evento entregado.

string

Valor permitido: 2026-10-01

occurredAt

obligatorio

string format: date-time

data

obligatorio

object

id

obligatorio

Pago al que se refiere el evento.

string

/^payment_[0-9a-hjkmnp-tv-z]{24,}$/

object

obligatorio

string

Valor permitido: payment

Respuestas

2XX

2XX

El evento fue aceptado.