Risk verification 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.

Value	Description
`REVIEW`	Risk verification is in progress
`IN_PROGRESS`	Risk verification is in progress. BILL waiting for more information about vendors in the organization. BILL requests the vendor in question for more information.
`HOLD`	Risk verification is complete. BILL has set the approval on hold. BILL requests the organization owner for more information.
`APPROVE`	Risk verification is complete. BILL has approved the organization for BILL AP and AR operations.
`DECLINE`	Risk verification is complete. BILL has declined risk approval for the organization.

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

Sample risk-verification.updated payload

Sample `risk-verification.updated` payload