MBTRUST_SUCCESS Event

This webhook event is sent when an MBTrust account provisioning operation completes successfully. This includes onboarding operations, document sync operations, and merchant updates.

When This Event Is Sent

The endpoint mbtrust.execute is used, and the execution is successful.
A user performs an MBTrust execution from the Underwriters Dashboard, and the execution is successful.

Decrypted Data Parameters

This event includes all default parameter for version 1.0 in the decrypted data parameter, plus the following parameters:

Parameter	Type	Required	Description
provisioning_data	object	Yes	Complete MBTrust provisioning entity data including execution results. See MBTrust Parameters below.

MBTrust Parameters

The provisioning_data object contains the complete MBTrust provisioning entity state, identical to the response from mbtrust.get.

For detailed documentation of all fields in the provisioning_data object, refer to the mbtrust.get endpoint documentation.

Example Payload

Note: This example shows the decrypted payload. When you receive this webhook, the data field will be encrypted. See the encryption reminder for details.

{
  "id": "wh_5f9NG3b4k5DWvgqwWJYxYz",
  "event_type": "MBTRUST_SUCCESS",
  "timestamp": "2026-03-17T21:56:38Z",
  "account_id": "account_id",
  "schema_version": "2025-11-21",
  "key_id": "whk_20260317_01",
  "data": {
    "version": "1.0",
    "subject_record_id": "sr_3qdwxc1uypBuVtU7t06ePH",
    "workflow_id": "w_1FrHoIUsE2K53Z2avBcDXm",
    "workflow_type": "BUSINESS_UNDERWRITING",
    "user_context": {
      "user_id": "SYSTEM",
      "user_type": "SYSTEM"
    },
    "provisioning_data": {
      "provisioning_type": "MBTRUST",
      "provisioning_sponsor": "MERRICK",
      "status": "CREATED",
      "created_at": "2026-03-17T21:56:29.408Z",
      "mbtrust_id": "ape_3dxjD8m34x4S193z3U9PHN",
      "updated_at": "2026-03-17T21:56:29.413Z",
      "execution_results": [
        {
          "status": "SUCCESS",
          "started_at": "2026-03-17T21:56:35.698Z",
          "finished_at": "2026-03-17T21:56:36.318Z",
          "operation_id": "apo_gSxOD2zDsAEVSVo96etdz",
          "operation_type": "onboarding",
          "errors": [],
          "provider_response": {
            "code": "SUCCESS",
            "details": {
              "data": {
                "mid": 1234177378410322,
                "isoId": 58,
                "status": "NotSubmitted"
              },
              "errors": [],
              "message": "Merchant onboarded successfully",
              "success": true
            },
            "message": "Merchant onboarded successfully",
            "external_reference_id": 1234177378410322
          }
        }
      ]
    }
  }
}

Using the Provisioning data

After receiving this webhook, you can use the mbtrust_id to download the document via the mbtrust.get