Risk verification webhook notification payloads

When you subscribe to a BILL event and the event triggers, BILL sends a notification to your provided notificationUrl. See /v3/risk-verifications in the API reference for more information about the request and response fields.

Sample risk-verification.updated payload

In this sample unescaped JSON payload, the status of an organization risk verification is available (REVIEW, IN_PROGRESS, HOLD, APPROVE, or DECLINE). See Users for BILL partners for more information.

    "metadata": {
        "eventId": "{event_id}",
        "subscriptionId": "{subscription_id}",
        "organizationId": "{organization_id}",
        "eventType": "risk-verification.updated",
        "version": "1"
  "risk-verification": {
    "decision": "APPROVE"