Health Check

General information

These Mambu Process Orchestrator (MPO) processes allow you to run health checks and validate the working of the connector. Before running these health checks please make sure to create custom fields for the Loan Accounts entity, as described in Mambu prerequisites.

Defined test cases

  1. Check connectivity between MPO and nCino
    Test case name - nCinoConnectivity.
    The nCino connectivity test makes a GET API call to:

    • Check the refresh token, to make sure it is created.
    • Verify nCino credentials.
  2. Check connectivity between MPO and Mambu
    Test case name - mambuConnectivity.
    The Mambu connectivity test makes a GET API call to check the provided Mambu credentials and permissions.

  3. Check configured custom fields in Mambu
    Test case name - mambuCustomFields.
    The custom fields sanity test makes a GET API call to check that the required custom fields are defined in Mambu.

  4. Check configured loan products in Mambu
    Test case name - mambuProducts.
    The loan products test uses the response from the previous connectivity test in Mambu to check that the same loan products in the config are defined in Mambu.

  5. Check configured loan products in nCino
    Test case name - nCinoProducts.
    The loan products test uses the response from the previous connectivity test in nCino to check that the same loan products in the config are defined in nCino.

  6. Check configured timezone setting in Mambu
    Test case name - mambuTimeZone.
    The Mambu timezone setting test makes a GET API call to check that the same timezone is defined in both Mambu and in the config.

  7. Validate nCino endpoints
    Test case name - nCinoEndpoints.
    The validate nCino endpoints setting test makes a GET API call for each endpoint used in the connector to check that the nCino package in Salesforce is properly installed.

  8. Check refresh token
    Test case name - nCinoRefreshToken.
    The Refresh Token test compares the current date with the nextRefreshDate parameter (found in Setup > Salesforce API OAuth > Salesforce configuration) to check if the refresh token is properly updated in nCino.

Successful responses

{
    "mambuConnectivity": {
        "Result": "Passed",
        "Message": "Connectivity between MPO and Mambu is successful!"
    },
    "mambuCustomFields": {
        "Result": "Passed",
        "Message": "All Config Custom Fields Set and Ids exist in Mambu"
    },
    "mambuProducts": {
        "Result": "Passed",
        "Message": "All Config Loan Product keys exist in Mambu"
    },
    "mambuTimeZone": {
        "Result": "Passed",
        "Message": "Config Time Zone is the same defined in Mambu Organization Setup."
    },
    "nCinoConnectivity": {
        "Result": "Passed",
        "Message": "Connectivity between MPO and nCino is successful!"
    },
     "nCinoEndpoints": {
        "Result": "Passed",
        "Message": " nCino package in Salesforce is properly installed."
    },
    "nCinoProducts": {
        "Result": "Passed",
        "Message": "All Config Loan Product keys exist in nCino"
    },
     "nCinoRefreshToken": {
        "Result": "Passed",
        "Message": "RefreshToken has been properly updated."
    }
}
ParameterTypeDescription
ResultstringThe result of the health check. Values can be Failed, Passed, or Error. An error is returned when the test case did not complete or is missing information.
MessagestringA message confirming the success of the test case.

Fail response

If a test case fails, the test case result is Failed and the message describes the issue.

{
    "mambuConnectivity": {
        "Result": "Failed",
        "Message": "Mambu connectivity error: INVALID_BASIC_AUTHORIZATION",
        "Process": "44069"
    }
}
ParameterTypeDescription
ResultstringThe result of the health check. Values can be Failed, Passed, or Error. An error is returned when the test case did not complete or is missing information.
MessagestringA message confirming the failure of the test case.
ProcessstringThe process ID, only supplied for error and failed statuses.

Error response

In case of error, the test case result is Error and the message describes the issue.

{
    "nCinoProducts": {
        "Result": "Error",
        "Message": "Something went wrong with nCino connectivity or config SD. Loan product list from nCino could not be retrieved.",
        "Process": "44067"
    }
}
ParameterTypeDescription
ResultstringThe result of the health check. Values can be Failed, Passed, or Error. An error is returned when the test case did not complete or is missing information.
MessagestringA message confirming the failure of the test case.
ProcessstringThe process ID, only supplied for error and failed statuses.