Kount API v2 (0.1.0)

Download OpenAPI specification:

Documentation for Kount API v2 Endpoints.

Kount API v2

An API for merchants to manage fraud and transaction data

3DS

Submit 3DS data

Submit 3DS data for a transaction.

Request Body schema: application/json
required

Expected payload with fields that may be submitted

trid
required
string^\w{1,12}$
threeDSRequestorChallengeInd
string^[0-9]{2}$
dsTransID
string^[a-zA-Z0-9-]{0,36}$
transStatusReason
string^([01][0-9])$|^(2[0-6])$
challengeDataEntry
string^Y|N$
whitelistingDataEntry
string^Y|N$
threeDSServerTransID
string^[a-zA-Z0-9-]{0,36}$
transStatus
string^Y|N|U|A|C|D|R|I$
mcc
string^[0-9]{4}$
acctID
string
acctInfo
string
acctNumber
string
acctType
string
acquirerBIN
string
acquirerMerchantID
string
acsChallengeMandated
string
acsCounterAtoS
string
acsDecConInd
string
acsHTML
string
acsOperatorID
string
acsReferenceNumber
string
acsRenderingType
string
acsSignedContent
string
acsTransID
string
acsURL
string
acsUiType
string
addrMatch
string
authenticationMethod
string
authenticationType
string
authenticationValue
string
billAddrCity
string
billAddrCountry
string
billAddrLine1
string
billAddrLine2
string
billAddrLine3
string
billAddrPostCode
string
billAddrState
string
broadInfo
string
browserAcceptHeader
string
browserColorDepth
string
browserIP
string
browserJavaEnabled
string
browserJavascriptEnabled
string
browserLanguage
string
browserScreenHeight
string
browserScreenWidth
string
browserTZ
string
browserUserAgent
string
cardExpiryDate
string
cardRangeData
string
cardholderInfo
string
cardholderName
string
challengeCancel
string
challengeCompletionInd
string
challengeHTMLDataEntry
string
challengeInfoHeader
string
challengeInfoLabel
string
challengeInfoText
string
challengeInfoTextIndicator
string
challengeNoEntry
string
challengeSelectInfo
string
challengeWindowSize
string
deviceChannel
string
deviceInfo
string
deviceRenderOptions
string
dsEndProtocolVersion
string
dsReferenceNumber
string
dsStartProtocolVersion
string
dsURL
string
eci
string
email
string
expandInfoLabel
string
expandInfoText
string
homePhone
string
interactionCounter
string
issuerImage
string
merchantCountryCode
string
merchantName
string
merchantRiskIndicator
string
messageCategory
string
messageExtension
string
messageType
string
messageVersion
string
mobilePhone
string
notificationURL
string
oobAppLabel
string
oobAppURL
string
oobContinue
string
oobContinueLabel
string
payTokenInd
string
payTokenSource
string
psImage
string
purchaseAmount
string
purchaseCurrency
string
purchaseDate
string
purchaseExponent
string
purchaseInstalData
string
recurringExpiry
string
recurringFrequency
string
resendChallenge
string
resendInformationLabel
string
resultsStatus
string
sdkAppID
string
sdkCounterStoA
string
sdkEncData
string
sdkEphemPubKey
string
sdkMaxTimeout
string
sdkReferenceNumber
string
sdkTransID
string
serialNum
string
shipAddrCity
string
shipAddrCountry
string
shipAddrLine1
string
shipAddrLine2
string
shipAddrLine3
string
shipAddrPostCode
string
shipAddrState
string
submitAuthenticationLabel
string
threeDSCompInd
string
threeDSReqAuthMethodInd
string
threeDSRequestorAppURL
string
threeDSRequestorAuthenticationInd
string
threeDSRequestorAuthenticationInfo
string
threeDSRequestorDecMaxTime
string
threeDSRequestorDecReqInd
string
threeDSRequestorID
string
threeDSRequestorName
string
threeDSRequestorPriorAuthenticationInfo
string
threeDSRequestorURL
string
threeDSServerOperatorID
string
threeDSServerRefNumber
string
threeDSServerURL
string
threeRIInd
string
whiteListStatus
string
whiteListStatusSource
string
whitelistingInfoText
string
whyInfoLabel
string
whyInfoText
string
workPhone
string

Responses

Request samples

Content type
application/json
{
  • "trid": "DX0J4QGKLH8L",
  • "threeDSRequestorChallengeInd": "10",
  • "dsTransID": "abcd-1234-231",
  • "transStatusReason": "04",
  • "challengeDataEntry": "N",
  • "whitelistingDataEntry": "Y",
  • "threeDSServerTransID": "wxyz-5678-333-123",
  • "transStatus": "A",
  • "mcc": "9999"
}

Response samples

Content type
application/json
{
  • "status": "ok",
  • "count": {
    },
  • "errors": [ ],
  • "result": {
    }
}

FraudStatus

Update

Update a transaction's fraud status data

Request Body schema: application/json
required

Expected payload with fields that may be updated:

trid
required
string^\w{1,12}$
fraudStatus
required
string^[TC40|SAFE|Other|None]$

Responses

Request samples

Content type
application/json
{
  • "trid": "DX0J0QGKLK8L",
  • "fraudStatus": "TC40"
}
%s - Kount API