Sending Data for Dispute and Chargeback Management

You can send transaction data to us through our API endpoints.

Upload API Specifications

Endpoints:

  • Sandbox: https://api-sandbox.kount.com/kff/uploads

  • Production: https://api.kount.com/kff/uploads

Method: POST

Header Authorization: Bearer <token>

Header Content-Type: application/json

Body: {"transactions": {“type” : “string”}}

Send your data in a JSON string format that is capable of parsing back to JSON. See Standard Transaction Data Elements for the elements to include.

Example JSON string for Upload API

{ "transactions": "[{\"authStatus\":\"A\",\"kountOrderNumber\":\"DVVN1ZZYU2L7\",\"paymentInformation\":{\"avsMatch\":\"False\",\"cardBin\":\"410045\",\"last4\":\"3847\",\"authCode\":\"3845737\",\"billingName\":\"JOHN DOE\",\"billingAddress1\":\"1005 W Main St\",\"billingAddress2\":\"\",\"billingCity\":\"Boise\",\"billingState\":\"ID\",\"postalCode\":\"83702\",\"billingCountry\":\"USA\"},\"additionalTransactionData\":{\"browserOrAppDesc\":\"Chrome 88.0.4324.182\",\"deviceType\":\"\"},\"customerEmailAddress\":\"john.doe@kount.com\",\"customerName\":\"JOHN DOE\",\"cvvValidatedAtPurchase\":\"False\",\"deviceID\":\"358680B39D5240A8C382A11F2EBC7150\",\"ipAddress\":\"81.233.22.53\",\"orderCurrency\":\"USD\",\"orderDateTime\":\"2021-02-21T12:22:13.000Z\",\"orderNumber\":\"ABC123\",\"orderTotal\":4783,\"shoppingCart\":[{\"itemDescription\":\"BLACK MAC KEYBOARD\",\"itemName\":\"MAC KEYBOARD\",\"quantity\":1,\"itemType\":\"ACCESSORIES\",\"itemID\":\"225\",\"price\":4783}]},{\"kountClientID\":\"999666\",\"authStatus\":\"A\",\"kountOrderNumber\":\"DVVN1ZZYU2L8\",\"paymentInformation\":{\"avsMatch\":\"False\",\"cardBin\":\"410394\",\"last4\":\"3948\",\"billingName\":\"JANE DOE\",\"billingAddress1\":\"1005 W Main St\",\"billingAddress2\":\"\",\"billingCity\":\"Boise\",\"billingState\":\"ID\",\"postalCode\":\"83702\",\"billingCountry\":\"USA\"},\"additionalTransactionData\":{\"deviceType\":\"iPhone 12\"},\"customerEmailAddress\":\"jane.doe@kount.com\",\"customerName\":\"Jane Doe\",\"cvvValidatedAtPurchase\":\"False\",\"deviceID\":\"358680B39D5240A8C382A11F2EBC7151\",\"ipAddress\":\"72.17.122.212\",\"orderCurrency\":\"USD\",\"orderDateTime\":\"2021-02-21T11:25:29.000Z\",\"orderNumber\":\"ABC124\",\"orderTotal\":1812,\"shoppingCart\":[{\"itemDescription\":\"MACHINE LEARNING FOR DUMMIES\",\"itemName\":\"MACHINE LEARNING\",\"quantity\":2,\"itemType\":\"BOOK (PRINTED)\",\"itemID\":\"A34322\",\"price\":906}]}]"
}

Example JSON for Upload API

[{"authStatus": "A","kountOrderNumber": "DVVN1ZZYU2L7","paymentInformation": {"avsMatch": "False","cardBin": "410045","last4": "3847","authCode": "3845737","billingName": "JOHN DOE","billingAddress1": "1005 W Main St","billingAddress2": "","billingCity": "Boise","billingState": "ID","postalCode": "83702","billingCountry": "USA"},"additionalTransactionData": {"browserOrAppDesc": "Chrome 88.0.4324.182","deviceType": ""},"customerEmailAddress": "john.doe@kount.com","customerName": "JOHN DOE","cvvValidatedAtPurchase": "False","deviceID": "358680B39D5240A8C382A11F2EBC7150","ipAddress": "81.233.22.53","orderCurrency": "USD","orderDateTime": "2021-02-21T12:22:13.000Z","orderNumber": "ABC123","orderTotal": 4783,"shoppingCart": [{"itemDescription": "BLACK MAC KEYBOARD","itemName": "MAC KEYBOARD","quantity": 1,"itemType": "ACCESSORIES","itemID": "225","price": 4783}]},{"kountClientID": "999666","authStatus": "A","kountOrderNumber": "DVVN1ZZYU2L8","paymentInformation": {"avsMatch": "False","cardBin": "410394","last4": "3948","billingName": "JANE DOE","billingAddress1": "1005 W Main St","billingAddress2": "","billingCity": "Boise","billingState": "ID","postalCode": "83702","billingCountry": "USA"},"additionalTransactionData": {"deviceType": "iPhone 12"}

Standard Transaction Data Elements

Include these fields in the transaction data

Field

Type

Size

Recommendation

Additional Info

authStatus

string

50

Recommended

D (decline) or A (authorized)

customerID

string

250

Recommended

Customer ID used by the merchant

paymentInformation

json object

     

avsMatch

string

10

Optional

Boolean string as "True" or "False"

cardBin

string

6

Recommended

First 6 of card used for purchase

last4

string

100

Recommended

Last 4 on card used for purchase

authCode

string

 

Recommended

Authorization code provided to authorize the purchase

arn

string

 

Recommended

Acquirer reference number

billingName

string

50

Recommended

Name on card used for purchase

billingAddress1

string

50

Recommended

Street address for card used for purchase

billingAddress2

string

50

Optional

Address line 2 for card used for purchase

billingCity

string

50

Optional

City for card used for purchase

billingState

string

50

Optional

Billing state for card used for purchase

postalCode

string

150

Optional

Zip or postal code for card used for purchase

billingCountry

string

50

Optional

Country for card used for purchase

additionalTransactionData

json object

     

deviceType

string

50

Optional

PC, iPhone, Android Phone, etc

browserOrAppDesc

string

50

Optional

For a web browser use IE, Chrome, Firefox etc or for other methods such as video game clients use XYZ Game Client or other description consumer will recognize

customerEmailAddress

string

50

Recommended

Customer email address

customerName

string

100

Recommended

Customer name

cvvValidatedAtPurchase

string

10

Optional

"True" or "False"

deviceID

string

50

Optional

Device ID

ipAddress

string

50

Recommended

IP Address

orderCurrency

string

10

Recommended

ISO 4217Alpha 3 ( “USD” )

orderDateTime

string

 

Required

ISO 8601 format in UTC time zone: YYYY-MM-DDThh:mm:ssZ

orderNumber

string

50

Required

A reference number by which the merchant can identify the transaction. This should be the ID that is sent to the acquirer.

invoiceNumber

string

50

Optional

A reference number by which the customer can identify the transaction.

orderTotal

int

11

Required

(Total amount of the order)*100 - Example $44.09 would be 4409

shoppingCart

json array of objects

     

itemID

string

50

Recommended

ID that identifies the product to the merchant, like a SKU.

itemType

string

200

Recommended

Type of item such as ebook, virtual currency, season pass, etc.

itemName

string

100

Recommended

What the item is known as in the merchant store

itemDescription

string

250

Recommended

Item description

quantity

int

 

Recommended

Quantity of item purchased

price

int

 

Recommended

(Price of item in order currency) * 100. Example $44.09 would be 4409


Was this article helpful?
1 out of 2 found this helpful