Saltar al contenido principal
WEBHOOK

Encabezados

Content-Type
string
requerido

Siempre JSON.

Allowed value: "application/json"
X-Webhook-Event
string
requerido

Nombre del evento.

Allowed value: "request.allDocumentsVerified"
X-Webhook-Id
string
requerido

Identificador del tipo de evento.

Allowed value: "9"
X-Webhook-Event-Id
string<uuid>
requerido

Identificador único de esta ocurrencia del evento, en formato UUID v4. Se repite en todos los reintentos y en los reenvíos. Úsalo para detectar entregas duplicadas. Ver Entregas y reintentos.

Ejemplo:

"3f6c2a1e-8b4d-4c2a-9e1f-7a5b6c8d9e0f"

X-Webhook-Timestamp
string
requerido

Momento en que Pruff generó la entrega, en segundos Unix.

Ejemplo:

"1769547728"

X-Webhook-Signature
string
requerido

Timestamp y firma HMAC-SHA256 de la entrega, con el formato t={timestamp},v1={firma}. Ver Headers y firma.

Ejemplo:

"t=1769547728,v1=2789cdd9...e734d"

X-Webhook-Attempt
enum<string>
requerido

Número de intento, de 1 a 4.

Opciones disponibles:
1,
2,
3,
4
X-Webhook-Replay
string

Solo viene en un reenvío pedido a Pruff, y siempre vale true. En una entrega normal y en sus reintentos no viene. Ver «Reenvíos» en Entregas y reintentos.

Allowed value: "true"

Cuerpo

application/json
requestId
integer
requerido

Identificador de la solicitud.

businessIdentifier
string
requerido

RUT del cliente de la solicitud. En confirming, es el cliente que paga a sus proveedores.

Ejemplo:

"76111111-1"

businessName
string
requerido

Razón social del cliente.

Ejemplo:

"Cliente Ejemplo SpA"

currency
enum<string>
requerido

Moneda de la solicitud.

Opciones disponibles:
CLP,
UF,
USD,
EUR,
UTM,
COP,
ARS,
PEN,
BRL,
MXN
requestType
string
requerido

Tipo de solicitud. Siempre factoring-request.

Allowed value: "factoring-request"
documents
object[]
requerido

Documentos de la solicitud.

Minimum array length: 1

Respuesta

200

Cualquier respuesta 2xx da la entrega por recibida. Pruff reintenta ante 408, 429, 5xx, un timeout o un error de red. Cualquier otro 4xx y cualquier 3xx son una falla definitiva y no se reintentan. Ver Entregas y reintentos.