Skip to main content

Business Registry Rejected

Webhook

Type: business_registry.rejected.v1

Occurs when a proposal to enroll a new business (e.g. a sole trader) has been rejected or withdrawn.

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 rejected. You may retrieve this proposal via the Business Registration API.
  • rejection_reason is the detailed reason why this proposal was rejected.

Example​

{
    "specversion": "1.0",
    "id": "01FBJ0PYJ7931K0CJ6GMP8N3WG",
    "type": "business_registry.rejected.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",
         "rejection_reason": "Some reason",
         "merchant_id": "1eb39178-c652-4784-9eee-af7e25b28a4c",
    }
}

Triggering in sandbox​

This webhook object is emitted whenever a proposal is rejected or withdrawn. To prompt Two to emit an example of this object, simply create and then withdraw a proposal.

Request​

Responses​

Successful Response