Business Statuses

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

Created: A business was created, or a business’s record was updated in a way that requires re-verification. A business in the created state can only send or receive funds with B2B Payments.
Verified: A business passed verification. The business can send or receive funds with all transfer use cases.
Rejected: A business did not pass verification. The business cannot send or receive funds.
Restricted: A business matched a sanctions list during watchlist screening. The business cannot send or receive funds.
Closed: A business has been soft deleted in Orum’s platform (this action can only be completed by the Orum team). The business cannot send or receive funds.

Note: 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".

The diagram below shows how a business can move through the above statuses. Note that 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, Orum will automatically kick off a manual review and attempt to retry the customer identification workflow to resolve the issue.

Business statuses diagram

Example Webhook Payload

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"
        }
    }
 }