Validate MBTrust account provisioning entity against required merchant data and configuration.

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

Usage Info

Validate that an MBTrust account provisioning entity has all required information to execute provisioning operations, including complete business data, owner information, bank accounts, sales information, documents, and partner configuration settings.

Use this method before calling mbtrust.execute to identify any missing requirements and ensure successful provisioning. The validation checks vary based on the operation type (onboarding vs. document sync) that will be executed.

For troubleshooting validation errors and finding the right API endpoints, see MBTrust Validation Reference.

Request

Authentication: KSig1-HMAC-SHA256

Parameters

Parameter	Type	Required	Description
mbtrust_id	string	Yes	The identifier for the MBTrust provisioning entity.

Example

{
  "mbtrust_id": "ape_7h1EpxerrZQyLnRC1EQ9Ck"
}

Response

Data

Parameter	Type	Description
can_execute	boolean	Specifies whether the MBTrust provisioning can be executed or not.
missing_requirements	array of objects	The missing requirements attribute is defined in the table below.

Missing Requirements Parameters

Parameter	Type	Description
code	string	Type of the missing requirement. One of MBTRUST_MISSING_REQUIREMENTS.
entity_type	string	Entity type related to the missing requirement. See MBTrust Validation Reference for the list of entity types and their required fields.
entity_id	string	Identifier for the entity with the missing requirement.
message	string	A descriptive message explaining the missing requirement.
related_methods	array	API methods that can be used to fulfill this requirement.
fields	array	When the missing requirement is of type `FIELDS_REQUIRED`, the list of fields missing from the specified entity.

Example without missing requirements

{
  "meta": {
    "status": "SUCCESS",
    "trace_id": "trc_6zNzQZHSf26V83BO3uW6dS",
    "version": "2025-03-24"
  },
  "data": {
    "can_execute": true,
    "missing_requirements": []
  }
}

Example with missing requirements

{
  "meta": {
    "status": "SUCCESS",
    "trace_id": "trc_6zNzQZHSf26V83BO3uW6dS",
    "version": "2025-03-24"
  },
  "data": {
    "can_execute": false,
    "missing_requirements": [
      {
        "code": "MID_REQUIRED",
        "entity_type": "Business",
        "entity_id": "b_6GO8a3o0K5TuzyPCgaXTIn",
        "message": "Merchant ID (MID) is required in business additional_fields.",
        "related_methods": [
          "business.update"
        ],
        "fields": [
          "additional_fields.merrick_mid"
        ]
      },
      {
        "code": "BUSINESS_OWNER_INFO_REQUIRED",
        "entity_type": "BusinessOwner",
        "message": "Business owner information is missing or incomplete.",
        "related_methods": [
          "person.create",
          "business.addOwner"
        ]
      },
      {
        "code": "FIELDS_REQUIRED",
        "entity_type": "Business",
        "entity_id": "b_2I1ISsWEQia02V9tfolNJB",
        "message": "Business with ID: [b_2I1ISsWEQia02V9tfolNJB] has missing fields",
        "related_methods": [
          "business.update"
        ],
        "fields": [
          "legal_name",
          "tax_id",
          "phone_number",
          "addresses"
        ]
      },
      {
        "code": "BUSINESS_BANK_ACCOUNT_INFORMATION_REQUIRED",
        "entity_type": "BusinessBankAccount",
        "message": "Bank account information is missing or incomplete for the business.",
        "related_methods": [
          "bankAccount.create",
          "business.addBankAccount"
        ]
      },
      {
        "code": "BUSINESS_SALES_INFO_REQUIRED",
        "entity_type": "BusinessSalesInfo",
        "message": "Sales information is missing for the business.",
        "related_methods": [
          "business.salesInfo.create"
        ]
      },
      {
        "code": "DOCUMENT_REQUIRED",
        "entity_type": "Document",
        "message": "Required document with type `BANK_STATEMENTS` is missing or not fulfilled.",
        "related_methods": [
          "document.create",
          "workflow.requiredDocument.fulfillment.batchAdd"
        ]
      },
      {
        "code": "MERCHANT_NOT_ONBOARDED",
        "entity_type": "Business",
        "entity_id": "b_yEIOPSFalooab1S9se7kj",
        "message": "Onboarding operation must be completed before document sync can be executed.",
        "related_methods": [
          "mbtrust.execute"
        ]
      },
      {
        "code": "ACCOUNT_PROVISIONING_ONBOARDING_DISABLED",
        "message": "Onboarding operations are disabled for this partner configuration.",
        "related_methods": []
      }
    ]
  }
}

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.