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
risk-verification.updated
payloadIn 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"
}
}
Updated 23 days ago