In Deliver, a business can have one of the following statuses, indicated by the status field.

A business was created, or a business’s record was updated in a way that requires re-verification.

If you are using your own customer identification provider (BYO-KYB), all businesses you create will automatically have a Verified status. The POST API response will return the business with a status of verified.

​
Diagram

The below example shows how a business can move through the above statuses. A business can move from “verified” to “restricted” if it matches a sanctions list anytime after its initial customer identification.

If a business fails customer identification and is set to the rejected status, we automatically kick off a manual review and attempt to retry the customer identification workflow to resolve the issue.

​
Webhook Example

Deliver sends webhooks to notify you of business status changes.

  {
      "event_id": "0b0bd7a4-c9aw-49d1-97da-7353ea40fd02",
      "event_type": "business_verified",
      "created_at": "2022-08-26T18:40:31.775Z",
      "event_data": {
          "business": {
              "id": "d2c780fd-cd60-495f-a63d-60d4709410e5",
              "legal_name": "My Company Inc",
              "entity_type": "sole_proprietorship",
              "tax_id": "012345678",
              "tax_id_type": "tin",
              "status": "verified",
              "addresses": [
                  {
                      "id": "cw9ad970-637f-4e4a-b808-917efce377db",
                      "address1": "10 Test st",
                      "city": "New York",
                      "state": "NY",
                      "country": "US",
                      "zip5": "10001",
                      "created_at": "2022-08-26T18:28:50.569975Z",
                      "updated_at": "2022-08-26T18:28:50.569975Z"
                  }
              ],
              "contacts": [
                  {
                      "id": "f8d8aa5-cdcf-4e31-82b4-c438e786e5f8",
                      "value": "[email protected]",
                      "created_at": "2022-08-26T18:28:50.569975Z",
                      "updated_at": "2022-08-26T18:28:50.569975Z"
                  },
                  {
                      "id": "b0278cp1-3d01-2640-b4s9-26a6d1f5b2cv",
                      "value": "mycompany.com",
                      "created_at": "2022-08-26T18:28:50.569975Z",
                      "updated_at": "2022-08-26T18:28:50.569975Z"
                  },
                  {
                      "id": "d1479dd1-2d98-4967-a4f8-18d9e1e9a8ad",
                      "value": "+15551234567",
                      "created_at": "2022-08-26T18:28:50.569975Z",
                      "updated_at": "2022-08-26T18:28:50.569975Z"
                  }
              ],
              "created_at": "2022-08-26T18:28:50.569975Z",
              "updated_at": "2022-08-26T18:29:12.052262Z"
          }
      }
   }

Was this page helpful?