Ongoing Monitoring Webhooks

Ongoing Monitoring (AML) Webhook Event

Quadrata will emit a webhook event (HTTP Request) whenever there is a change to a passport's AML score. The payload for this request will contain both, the previous AML score, and the updated AML score, along with the associated wallet address.

Ongoing monitoring is a premium feature. Contact Quadrata at [email protected] to enable ongoing monitoring for your dApp.

Payload Structure

Webhooks are sent over HTTPS with a signature verification header. Each payload will include the following data:

Request Header

Each webhook request that Quadrata emits will contain a header signature that an integrating application can use to verify the authenticity of the message.

• X-WEBHOOK-SIGNATURE - Base64 Encoded SHA384 request signature.

See Webhook Request Signaturefor more information on how to verify the webhook request signature.

Request Body

• eventId - The UUID for the event that triggered this webhook

• monitoring - JSON payload with the data that was monitored and the monitoring type (AML)

• nonce - To ensure the signature is always unique

• timestamp - Unix epoch representing the time when the notification was triggered

• type - Representing the type of notification, MONITORING

• walletAddress - Wallet address associated to the passport

Quadrata will attempt to deliver a webhook payload up to 3 times for each configured URI, if an HTTP response status code is returned outside of the 2xx range (200, 201, etc).

{
  "eventId": "5bab4b6d-8f6b-48c3-ab19-4d1e423ae4be",
  "monitoring": { 
    "previousScore": 1, 
    "score": 3, 
    "type": "AML" 
  },
  "nonce": "e1b2f73a",
  "timestamp": 1703201319,
  "type": "MONITORING",
  "walletAddress": "0x9b913Bb99324963Dc4B772E1e35AE23df0cACDeD"
}

Monitoring events will always contain the single passport wallet address associated to the AML score that was updated.

Unlike onboarding notifications, this field is not a list, but a single string.