Pagos Webhooks

3 eventos

Cabeceras comunes

Cada petición de webhook incluye estas cabeceras:

x-holded-webhook-eventstring

Nombre del evento, p. ej. invoice.create

x-holded-webhook-datestring · ISO 8601

Momento del envío, p. ej. 2026-06-18T11:10:35Z

x-holded-webhook-signaturestring

Firma HMAC-SHA256 con prefijo sha256= (ver abajo)

x-holded-webhook-idstring

Identificador único del evento; úsalo como clave de idempotencia

x-holded-webhook-account-idstring

Identificador de la cuenta de Holded que origina el evento

x-holded-webhook-versionstring

Versión del sistema de webhooks (p. ej. v1)

payment.createPOST

Pago creado

Se envía cuando se crea un pago en Holded.

Payload

object

Datos del pago incluidos en los payloads de webhook

idstring

Identificador único del pago

descriptionstring

Descripción del pago

amountstring | null

Importe del pago

contactIdstring | null

Identificador único del contacto

contactNamestring | null

Nombre del contacto

datestring | null

Fecha del pago en formato ISO 8601

statusstring | null

Estado del pago: no_paid, paid, partial_paid

bankingAccountIdstring | null

Identificador único de la cuenta bancaria asociada

reconciliationStatusstring | null

Estado de conciliación: pending, reconciled, partial_reconciled

Payload de ejemplo

json

{
  "id": "string",
  "description": "string",
  "amount": "string",
  "contactId": "string",
  "contactName": "string",
  "date": "string",
  "status": "string",
  "bankingAccountId": "string",
  "reconciliationStatus": "string"
}

payment.updatePOST

Pago actualizado

Se envía cuando se actualiza un pago existente en Holded.

Payload

object

Datos del pago incluidos en los payloads de webhook

idstring

Identificador único del pago

descriptionstring

Descripción del pago

amountstring | null

Importe del pago

contactIdstring | null

Identificador único del contacto

contactNamestring | null

Nombre del contacto

datestring | null

Fecha del pago en formato ISO 8601

statusstring | null

Estado del pago: no_paid, paid, partial_paid

bankingAccountIdstring | null

Identificador único de la cuenta bancaria asociada

reconciliationStatusstring | null

Estado de conciliación: pending, reconciled, partial_reconciled

Payload de ejemplo

json

{
  "id": "string",
  "description": "string",
  "amount": "string",
  "contactId": "string",
  "contactName": "string",
  "date": "string",
  "status": "string",
  "bankingAccountId": "string",
  "reconciliationStatus": "string"
}

payment.deletePOST

Pago eliminado

Se envía cuando se elimina un pago en Holded.

Payload

object

Datos del pago incluidos en los payloads de webhook de eliminación

idstring

Identificador único del pago

Payload de ejemplo

json

{
  "id": "string"
}