9οΈβ£Webhooks
If you want a simple test for webhook notifications, you can set up a catch-all webhook endpoint via https://webhook.site/. You will have a unique generated URL you can use to receive notifications from OffBlocks API.
Please, follow the steps from Webhooks to set up and manage webhook notifications. For example, to set up a webhook notification for all entities' updates as a POST
request to https://webhook.site/81f3f721-303e-4b3c-899f-57db55aa5262, make a PUT
request to /webhooks
with the following payload:
{
"callbackUrl": "https://webhook.site/81f3f721-303e-4b3c-899f-57db55aa5262",
"types": [
"customer.updated",
"account.updated",
"card.updated",
"authorisation.updated",
"transaction.updated"
]
}
Creates new webhook subscription or updates an existing one
HTTP message signature
HTTP message signature input
Idempotency key (UUID)
Content digest
Unique ID of the webhook to be updated
URL to be subscribed for receiving events
https://example.com/callback
PUT /v1/webhooks HTTP/1.1
Host: api.offblocks.xyz
Authorization: Bearer JWT
Signature: text
Signature-Input: text
Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000
Content-Digest: text
Content-Type: application/json
Accept: */*
Content-Length: 119
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"callbackUrl": "https://example.com/callback",
"types": [
"customer.updated"
]
}
{
"id": "123e4567-e89b-12d3-a456-426614174000",
"callbackUrl": "https://example.com/callback",
"types": [
"customer.updated"
],
"createdAt": "2025-07-12T09:12:28.777Z",
"updatedAt": "2025-07-12T09:12:28.777Z"
}
Once you create a new customer entity in step Customer Creation, you will receive a notification similar to the following:
{
"chainId": "eip155:300:0x43158f45b5EbD7b1179130130DF00393928C2691",
"createdAt": "2024-01-24T14:18:37.749861007Z",
"eventId": "fb2ed25e-11b1-49ce-a703-75f0c2d58c09",
"externalId": "5fb1479a-0ef4-418e-82b5-0eb76f8a3df9",
"id": "29ca152b-a06a-5f6d-8f34-06a8f1250141",
"status": "initiating",
"updatedAt": "2024-01-24T14:18:37.749861007Z",
"webhookType": "customer.updated"
}
Last updated