You can send transaction data to us through our API endpoints.
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.
{ "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}]}]" }
[{"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"}
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 |