Collaborative Underwriting

Collaborative Underwriting is self-service in your Test Environment. In the Live Environment, the feature must be enabled for your Product by the Highnote Team.

Collaborative application decisioning empowers you or your underwriter to provide a recommended APPROVED or DENIED decision on applications for your product based on your credit policy. Highnote will execute regulatory checks against the application, such as KYC, KYB, and OFAC, and utilize your recommended decision to determine a final application decision. Highnote can help you adjust the sequencing of application decisioning calls and rules execution may be configured to the specific needs of your product and credit policy.

In this guide, we’ll assume that you or your underwriter will first provide a recommended decision based on credit risk after identity and fraud verification checks are run on the application by Highnote to make a final decision.

The easiest way to enable collaborative application underwriting is from the Highnote Dashboard in your product's settings.

You can also enable the feature from the API.

Receiving Events & Notifications requires you setup a Notification Target.

After the application has been submitted to Highnote, you will receive the notification event CARD_PRODUCT_APPLICATION_UNDERWRITING_DECISION_REQUESTED to request an underwriting decision from you or your underwriter.

Example Event Payload

Copy code snippet
{
  "data": {
    "node": {
      "__typename": "NotificationEvent",
      "createdAt": "2022-12-12T16:32:49.125Z",
      "id": "NOTIFICATION_EVENT_ID",
      "name": "CARD_PRODUCT_APPLICATION_UNDERWRITING_DECISION_REQUESTED",
      "node": {
        "__typename": "AccountHolderCardProductApplication",
        "applicationState": {
          "status": "PENDING"
        },
        "createdAt": "2022-12-12T16:32:44.499Z",
        "id": "APPLICATION_ID",
        "updatedAt": "2022-12-12T16:32:44.499Z"
      }
    }
  },
  "extensions": {
    "signatureTimestamp": 1670862772620
  }
}

Highnote will then await your call with your underwriting decision.

For an APPROVE decision, you need to provide the credit limit decision, which you will need to assign on the financial account once created. If you do not know the initial credit limit at the time of the underwriting decision, you can provide a $0 credit limit and set the credit limit on the financial account later.

For a DENIED decision, the overall application will be DENIED, and you must provide the applicable adverse action reason(s) based on your credit policy. If a decision is not received within 30 days from the application creation date, the application status will transition to DENIED.

A full list of adverse action reasons are available in the API Reference.

Upon receiving an underwriting decision, the application’s status will be PENDING while Highnote proceeds forward with the application workflow and determines a final application decision. You can check for updates to the application’s status using the GetAccountHolderCardProductApplication query or subscribe to the application status events to receive a notification when the application’s status changes.