Skip to main content

Business Registry Approved

Webhook

Type: business_registry.approved.v1

Occurs when a proposal to enroll a new business (e.g. a sole trader) has been approved, the enrollment has been completed, and the new business is ready for ordering/trade account creation/etc.

Payload​

The data object in the payload contains the following:

  • merchant_id is your unique identifier within TWO's system
  • proposal_id is the identifier of the proposal that has been approved. You may retrieve this proposal via the Business Registration API.
  • organization_number is the synthetic organization number generated by TWO for the newly enrolled business. Use this organization number when creating trade accounts, orders or other assets on behalf of the buyer.

Example​

{
    "specversion": "1.0",
    "id": "01FBJ0PYJ7931K0CJ6GMP8N3WG",
    "type": "business_registry.approved.v1",
    "time": "2023-06-21T12:34:56.123456Z",
    "source": "https://api.two.inc",
    "subject": "business_registry",
    "twomerchantid":"b6b9d5d1-f6b7-4e15-9703-9c32c6e5c1c2",
    "data": {
        "proposal_id": "558f57b4-8161-4765-a73e-a67d73f9c245",
        "merchant_id": "1eb39178-c652-4784-9eee-af7e25b28a4c",
        "organization_number": "1234567",
    }
}

Triggering in sandbox​

This webhook object is emitted whenever a proposal is approved. In the sandbox environment, proposals are automatically approved immediately on submission. To prompt Two to emit an example of this object, simply create and then submit a proposal.

Request​

Responses​

Successful Response