Understanding the Kount response

When you perform a Kount verification your response will include an object called kountResponse.
It consists of two parts: status and rules.

{
  "token": {...},
  "card": {...},
  "data": {...},
  "kountResponse": {
    "status": "success",
    "rules": "{\"VERS\":\"0630\",\"MODE\":\"Q\"}"
  },
  "cardType": "visa"
}

Status

There are four possible statuses. The status indicates what action will be taken. The action will differ based on the endpoint. See below for more information:

  • Success:
    • Run Card Transaction: Based on the Kount rule(s) configured, the transaction will be processed with no further action required.
    • Save Card: The card will be saved with no further action required.
  • Review:
    • Run Card Transaction: Based on the Kount rule(s) triggered, the transaction has been run as an auth only, meaning the transaction has been authorized but is pending further action.
      You can manually approve or decline these transactions in the Fraud tab of Nexio Dashboard.
      (Please note that these transactions will auto-approve after 48 hours if no action is taken.)

      📘

      Note

      A transaction that goes into Review with Kount but declines with the gateway will not be available in the dashboard for manual approval. You need to attempt the transaction again.

    • Save Card: A 'Review' status will not prevent the card from being saved.
  • Decline:
    • Run Card Transaction: Based on the Kount rule(s) triggered, the transaction will not be processed with no further action required.
    • Save Card: The card will not be saved.
  • Error:
    • Run Card Transaction: Based on the Kount rule(s) triggered, the transaction will be processed with no further action required.
    • Save Card: The card will be saved.

Rules

This part of the response will include Kount-specific information including Kount version, mode, transaction ID, and a brief description of each rule that was triggered.

"kountResponse": {
    "status": "success",
    "rules": "{
        "VERS": "0630",
        "MODE": "W",
        "TRAN": "79970C4SYHL2",
        "SESS": "61504d7500d44f67bba921474750f90f",
        "ORDR": "456",
        "AUTO": "A",
        "SCOR": "76",
        "RULES_TRIGGERED": 2,
        "RULE_ID_0": "1004064",
        "RULE_DESCRIPTION_0": "Scorecard:  Distance from Device to Billing > 1000km (1)",
        "RULE_ID_1":"1004066",
        "RULE_DESCRIPTION_1":"Scorecard:  Billing Country not equal to BIN Country (Visa/MC)
    }"
}