Pagaments Webhooks

3 esdeveniments

Capçaleres comunes

Cada petició de webhook inclou aquestes capçaleres:

x-holded-webhook-eventstring

Nom de l'esdeveniment, p. ex. invoice.create

x-holded-webhook-datestring · ISO 8601

Moment de l'enviament, p. ex. 2026-06-18T11:10:35Z

x-holded-webhook-signaturestring

Signatura HMAC-SHA256 amb prefix sha256= (vegeu a sota)

x-holded-webhook-idstring

Identificador únic de l'esdeveniment; utilitza'l com a clau d'idempotència

x-holded-webhook-account-idstring

Identificador del compte de Holded que origina l'esdeveniment

x-holded-webhook-versionstring

Versió del sistema de webhooks (p. ex. v1)

payment.createPOST

Pagament creat

S'envia quan es crea un pagament a Holded.

Payload

object

Dades del pagament incloses en els payloads de webhook

idstring

Identificador únic del pagament

descriptionstring

Descripció del pagament

amountstring | null

Import del pagament

contactIdstring | null

Identificador únic del contacte

contactNamestring | null

Nom del contacte

datestring | null

Data del pagament en format ISO 8601

statusstring | null

Estat del pagament: no_paid, paid, partial_paid

bankingAccountIdstring | null

Identificador únic del compte bancari associat

reconciliationStatusstring | null

Estat de conciliació: pending, reconciled, partial_reconciled

Payload d'exemple

json

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

payment.updatePOST

Pagament actualitzat

S'envia quan s'actualitza un pagament existent a Holded.

Payload

object

Dades del pagament incloses en els payloads de webhook

idstring

Identificador únic del pagament

descriptionstring

Descripció del pagament

amountstring | null

Import del pagament

contactIdstring | null

Identificador únic del contacte

contactNamestring | null

Nom del contacte

datestring | null

Data del pagament en format ISO 8601

statusstring | null

Estat del pagament: no_paid, paid, partial_paid

bankingAccountIdstring | null

Identificador únic del compte bancari associat

reconciliationStatusstring | null

Estat de conciliació: pending, reconciled, partial_reconciled

Payload d'exemple

json

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

payment.deletePOST

Pagament eliminat

S'envia quan s'elimina un pagament a Holded.

Payload

object

Dades del pagament incloses en els payloads de webhook d'eliminació

idstring

Identificador únic del pagament

Payload d'exemple

json

{
  "id": "string"
}