Initiate MBTrust account provisioning operations for onboarding or document synchronization.

POST http://api.kompliant.com/mbtrust.execute (OpenAPI specification)

Usage Info

Use this method to initiate the MBTrust account provisioning operations. This method should only be called after mbtrust.canExecute confirms all requirements are met. The operation type (onboarding or document sync) is determined automatically based on the entity's current state and the merchant's onboarding status.

Operations are processed asynchronously. Use mbtrust.get to check execution status and results.

Request

Authentication: KSig1-HMAC-SHA256

Parameters

Field	Type	Required	Description
`mbtrust_id`	string	Yes	The MBTrust provisioning entity ID (format: `ape_XXXXX...`). Obtained from `mbtrust.create` response.
`documents`	object	No	Optional document selection for `DOCUMENT_SYNC` operations. When omitted, all eligible documents are synced.

Documents parameters

Field	Type	Required	Description
`uploaded_documents`	array	Yes	Array of document IDs (format: `d_XXXXX...`) to include in the document sync operation.

Example

To sync only specific documents, provide their IDs in the documents.uploaded_documents array:

{
  "mbtrust_id": "ape_4kz3kXp8dL2Xnj97xzFMuG",
  "documents": {
    "uploaded_documents": [
      "d_21lpM4CECgfdKyfGQ338u",
      "d_7KmN3pR8xL2Yj5qW9vB4Tc"
    ]
  }
}

Response

Data

Parameter	Type	Description
mbtrust	object	The mbtrust parameter is defined in the table below.

MBTrust Parameters

Field	Type	Description
`mbtrust_id`	string	The identifier for the MBTrust provisioning entity.
`queued_operations`	array	Account provisioning operations that have been queued for processing. Each operation is one of ACCOUNT_PROVISIONING_OPERATIONS .

Example

{
  "meta": {
    "status": "SUCCESS",
    "version": "2025-03-24"
  },
  "data": {
    "mbtrust": {
      "mbtrust_id": "ape_4kz3kXp8dL2Xnj97xzFMuG",
      "queued_operations": ["ONBOARDING", "DOCUMENT_SYNC"]
    }
  }
}

Errors

Error Code	HTTP Code	Possible Cause
BAD_REQUEST	400	Required parameters not provided.
ENTITY_NOT_FOUND	400	The `mbtrust_id` provided does not exist.
SYSTEM_RULE_VIOLATION	400	System rule violations are described below.
ACCOUNT_CONFIGURATION_VIOLATION	400	Account configuration rule violations are described below.

System Rule Violations

When a SYSTEM_RULE_VIOLATION error occurs, the response will include additional entity_type and sub_code fields to provide more specific information:

Entity Type	Sub-code	Description
Workflow	WORKFLOW_NOT_STARTED	The workflow must be in STARTED state before executing provisioning operations.
AccountProvisioning	PRECHECK_FAILED	Precheck validation failed. Use `mbtrust.canExecute` to identify missing requirements before calling execute.
AccountProvisioning	BUSINESS_NOT_FOUND	No business found for the subject record associated with this entity.

Account Configuration Violations

When a ACCOUNT_CONFIGURATION_VIOLATION error occurs, the response will include additional entity_type and sub_code fields to provide more specific information:

Entity Type	Sub-code	Description
AccountProvisioning	ACCOUNT_PROVISIONING_DISABLED	The account provisioning feature is disabled for this account.
AccountProvisioning	PROVISIONER_DISABLED	The MBTrust provisioner is disabled for this account.