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.

ValueDescription
IN_PROGRESSAutomatic risk verification is in progress.
HOLDBILL has set the verification process on hold and money movement is disabled for the organization. BILL is requesting the organization owner for more information.
REVIEWManual risk verification is required. The manual risk verification will take place when a payment is made. Organization users can continue to schedule payments.
APPROVEBILL has approved the organization for BILL AP and AR operations.
DECLINEBILL has declined approval for the organization.
{
    "metadata": {
        "eventId": "{event_id}",
        "subscriptionId": "{subscription_id}",
        "organizationId": "{organization_id}",
        "eventType": "risk-verification.updated",
        "version": "1"
    },
  "risk-verification": {
    "decision": "APPROVE"
  }
}