Send webhook test

Send a signed test event and inspect destination status, timing, request, and response.

POST/webhooks/test

Service: Webhook Test
Billing: On success

Request

urlrequired

string

A valid HTTPS destination URL in production.

payload

object

Optional JSON data placed under the event data field.

headers

Record<string, string>

Optional custom destination headers.

curl https://api.finap.uk/api/v1/webhooks/test -X POST \
  -H "Authorization: Bearer $FINAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/webhooks",
    "payload": { "orderId": "ord_0192" }
  }'

Delivered event

FINAP wraps your payload in a standard event envelope and adds delivery metadata headers.

X-Finap-Delivery-Id

string

Unique delivery identifier.

X-Finap-Timestamp

string

Delivery timestamp.

X-Finap-Signature

sha256=…

HMAC signature emitted by FINAP.

{
  "id": "delivery_id",
  "type": "webhook.test",
  "createdAt": "2026-07-18T09:00:00.000Z",
  "data": {
    "orderId": "ord_0192"
  }
}