The following tables show which Orders API (Payments Fraud) properties map to a corresponding Risk Inquiry Services (RIS, Command) API property. You can use this information as a reference when upgrading from Command to Payments Fraud in Kount 360.
sidebar. Request properties
|
RIS Category |
Notes |
||
|
MERC |
System Information |
The Bearer token identifies the customer’s org/client. |
MERC does not directly compare to the bearer token. |
|
VERS |
System Information |
|
VERS was part of the endpoint URL and is not a a data point included in the Orders API request. |
|
ORDR |
System Information |
merchantOrderId |
|
|
SITE |
System Information |
channel |
|
|
SESS |
System Information |
deviceSessionId |
|
|
N/A |
creationDateTime |
New data field for the Orders API. |
|
|
IPAD |
System Information |
userIp |
|
|
N/A |
account |
||
|
UNIQ |
Misc Information |
account.id |
|
|
N/A |
account.type |
||
|
EPOC |
Misc Information |
account.creationDateTime |
|
|
N/A |
account.username |
||
|
N/A |
account.accountIsActive |
||
|
N/A |
items |
||
|
N/A |
items.id |
||
|
PROD_PRICE[0] |
Product Details |
items.price |
|
|
PROD_DESC[0] |
Product Details |
items.description |
|
|
N/A |
items.name |
||
|
PROD_QUANT[0] |
Product Details |
items.quantity |
|
|
PROD_TYPE[0] |
Product Details |
items.category |
|
|
N/A |
items.subCategory |
||
|
N/A |
items.isDigital |
||
|
PROD_ITEM[0] |
Product Details |
items.sku |
|
|
N/A |
items.upc |
||
|
N/A |
items.brand |
||
|
N/A |
items.url |
||
|
N/A |
items.imageUrl |
||
|
N/A |
items.physicalAttributes |
||
|
N/A |
items.physicalAttributes.color |
||
|
N/A |
items.physicalAttributes.size |
||
|
N/A |
items.physicalAttributes.weight |
||
|
N/A |
items.physicalAttributes.height |
||
|
N/A |
items.physicalAttributes.width |
||
|
N/A |
items.physicalAttributes.depth |
||
|
N/A |
items.descriptors |
||
|
N/A |
items.isService |
||
|
N/A |
fulfillment |
||
|
N/A |
fullfillment.merchantFulfillmentId |
||
|
SHTP |
Shipping Information |
fulfillment.type |
SHTP has been split into two properties for Orders, Type examples include |
|
N/A |
fulfillment.items |
||
|
N/A |
fulfillment.status |
||
|
N/A |
fulfillment.accessUrl |
||
|
N/A |
fulfillment.shipping |
||
|
N/A |
fulfillment.shipping.amount |
||
|
N/A |
fulfillment.shipping.provider |
||
|
N/A |
fulfillment.shipping.trackingNumbers |
||
|
SHTP |
Shipping Information |
fulfillment.shipping.method |
SHTP has been split into two properties for Orders, Fulfillment examples include |
|
N/A |
fulfillment.recipientPerson |
||
|
N/A |
fulfillment.recipientPerson.name |
||
|
S2NM |
Shipping Information |
fulfillment.recipientPerson.name.first fulfillment.recipientPerson.name.family |
|
|
N/A |
fulfillment.recipientPerson.name.middle |
||
|
N/A |
fulfillment.recipientPerson.name.prefix |
||
|
N/A |
fullfillment.recipientPerson.name.suffix |
||
|
N/A |
fulfillment.recipientPerson.name.preferred |
||
|
N/A |
fulfillment.recipientPerson.dateOfBirth |
||
|
S2EM |
Shipping Information |
fulfillment.recipientPerson.emailAddress |
|
|
S2PN |
Shipping Information |
fulfillment.recipientPerson.phoneNumber |
|
|
N/A |
fulfillment.recipientPerson.address |
||
|
S2A1 |
Shipping Information |
fulfillment.recipientPerson.address.line1 |
|
|
S2A2 |
Shipping Information |
fulfillment.recipientPerson.address.line2 |
|
|
S2CI |
Shipping Information |
fulfillment.recipientPerson.address.city |
|
|
S2ST |
Shipping Information |
fulfillment.recipientPerson.address.region |
|
|
S2CC |
Shipping Information |
fulfillment.recipientPerson.address.countryCode |
|
|
S2PC |
Shipping Information |
fulfillment.recipient.address.postalCode |
|
|
N/A |
fulfillment.store |
||
|
N/A |
fulfillment.store.id |
||
|
N/A |
fulfillment.store.name |
||
|
N/A |
fulfillment.store.address |
||
|
N/A |
fulfillment.store.address.addressType |
||
|
N/A |
fulfillment.store.address.line1 |
||
|
N/A |
fulfillment.store.address.line2 |
||
|
N/A |
fulfillment.store.address.city |
||
|
N/A |
fulfillment.store.address.region |
||
|
N/A |
fulfillment.store.address.countryCode |
||
|
N/A |
fulfillment.store.address.postalCode |
||
|
N/A |
transactions |
||
|
N/A |
transactions.merchantTransactionId |
||
|
N/A |
transactions.processor |
||
|
N/A |
transactions.processorMerchantId |
||
|
N/A |
transactions.payment |
||
|
PTYP |
Payment Information |
transactions.payment.type |
|
|
PTOK |
Payment Information |
transactions.payment.paymentToken |
The tokenized or hashed payment token used in the order. |
|
PENC |
Payment Information |
N/A |
|
|
MASK |
Payment Information |
N/A |
|
|
LBIN |
Payment Information |
transactions.payment.bin |
The first 6-8 digits of the 16 digit Primary Account Number (PAN). |
|
LAST4 |
Payment Information |
transactions.payment.last4 |
|
|
N/A |
transactions.subtotal |
||
|
TOTL |
Payment Information |
transactions.orderTotal |
|
|
CURR |
Payment Information |
transactions.currency |
|
|
N/A |
transactions.tax |
||
|
N/A |
transactions.tax.isTaxable |
||
|
N/A |
transactions.tax.taxableCountryCode |
||
|
N/A |
transactions.tax.taxAmount |
||
|
N/A |
transactions.tax.outOfStateTaxAmount |
||
|
N/A |
transactions.billedPerson |
||
|
N/A |
transactions.billedPerson.name |
||
|
NAME |
Billing Information |
transactions.billedPerson.name.first transactions.billedPerson.name.family |
|
|
N/A |
transactions.billedPerson.name.middle |
||
|
N/A |
transactions.billedPerson.name.prefix |
||
|
N/A |
transactions.billedPerson.name.suffix |
||
|
N/A |
transactions.billedPerson.name.preferred |
||
|
EMAL |
Billing Information |
transactions.billedPerson.emailAddress |
|
|
B2PN |
Billing Information |
transactions.billedPerson.phoneNumber |
|
|
N/A |
transactions.billedPerson.address |
||
|
B2A1 |
Billing Information |
transactions.billedPerson.address.line1 |
|
|
B2A2 |
Billing Information |
transactions.billedPerson.address.line2 |
|
|
B2CI |
Billing Information |
transactions.billedPerson.address.city |
|
|
B2ST |
Billing Information |
transactions.billedPerson.address.region |
|
|
B2PC |
Billing Information |
transactions.billedPerson.address.postalCode |
|
|
B2CC |
Billing Information |
transactions.billedPerson.address.countryCode |
|
|
DOB |
transactions.billedPerson.dateOfBirth |
||
|
N/A |
transactions.transactionStatus |
||
|
N/A |
transactions.authorizationStatus |
||
|
AUTH |
Payment Information |
transactions.authorizationStatus.authResult |
|
|
N/A |
transactions.authorizationStatus.dateTime |
||
|
N/A |
transactions.authorizationStatus.verificationResponse |
||
|
AVST |
transactions.authorizationStatus.verificationResponse.avsStatus |
||
|
AVSZ |
transactions.authorizationStatus.verificationResponse.avsStatus |
||
|
CVVR |
transactions.authorizationStatus.verificationResponse.cvvStatus |
||
|
N/A |
transactions.authorizationStatus.declineCode |
||
|
N/A |
transactions.authorizationStatus.processorAuthCode |
||
|
N/A |
transactions.authorizationStatus.processorTransactionId |
||
|
N/A |
transactions.authorizationStatus.acquirerReferenceNumber |
||
|
N/A |
transactions.items |
||
|
N/A |
transactions.items.id |
||
|
N/A |
transactions.items.quantity |
||
|
N/A |
promotions |
||
|
N/A |
promotions.id |
||
|
N/A |
promotions.description |
||
|
N/A |
promotions.status |
||
|
N/A |
promotions.statusReason |
||
|
N/A |
promotions.discount |
||
|
N/A |
promotions.discount.percentage |
||
|
N/A |
promotions.discount.amount |
||
|
N/A |
promotions.discount.currency |
||
|
N/A |
promotions.credit |
||
|
N/A |
promotions.credit.currency |
||
|
N/A |
promotions.credit.creditType |
||
|
N/A |
promotions.credit.amount |
||
|
N/A |
loyalty |
||
|
N/A |
loyalty.id |
||
|
N/A |
loyalty.description |
||
|
N/A |
loyalty.credit |
||
|
N/A |
loyalty.credit.creditType |
||
|
N/A |
loyalty.credit.amount |
||
|
N/A |
loyalty.credit.currency |
||
|
UDF[] |
customFields |
||
|
MACK |
System Information |
N/A |
The customer's acknowledgement to ship/process an order. In Command, this value is hardcoded as Y. |
|
ANID |
System Information |
N/A |
The Automatic Number Identification (Caller ID) submitted with an order. If the ANI cannot be determined, set the value to 0123456789. In Command, this is only available in Mode P. |
|
CASH |
Misc Information |
N/A |
The total monetary value of goods in the order. |
|
GENDER |
Misc Information |
N/A |
M for male or F for female |
|
UAGT |
Misc Information |
N/A |
Customer User-Agent HTTP header. |
|
FRMT |
Misc Information |
N/A |
Specifies the format of the RIS response if the customer is not using an SDK. The options are XML, JSON, and YAML. Hard code the RIS API to JSON. |
sidebar. Response properties
|
RIS API Property |
Orders API Property |
Notes |
|
MODE |
The Orders API |
|
|
VERS |
version |
|
|
N/A |
order |
|
|
TRAN |
order.orderId |
|
|
ORDR |
order.merchantOrderId |
|
|
SITE |
order.channel |
|
|
SESS |
order.deviceSessionId |
|
|
N/A |
order.creationDateTime |
|
|
N/A |
order.riskInquiry |
|
|
N/A |
order.riskInquiry.guidance |
|
|
AUTO |
order.riskInquiry.decision |
|
|
OMNISCORE |
order.riskInquiry.omniscore |
|
|
N/A |
order.riskInquiry.persona |
|
|
N/A |
order.riskInquiry.persona.uniqueCards |
|
|
DEVICES |
order.riskInquiry.persona.uniqueDevices |
|
|
EMAILS |
order.riskInquiry.persona.uniqueEmails |
|
|
N/A |
order.riskInquiry.device |
|
|
FINGERPRINT KAPT |
order.riskInquiry.device.id |
If the device data collection process did not finish collecting (KAPT), then this property will not be populated. |
|
N/A |
order.riskInquiry.device.collectionDateTime |
|
|
BROWSER |
order.riskInquiry.device.browser |
|
|
N/A |
order.riskInquiry.device.deviceAttributes |
|
|
OS MOBILE_DEVICE MOBILE_TYPE |
order.riskInquiry.device.deviceAttributes.os |
The OS can be used to determine whether the device is a mobile device. It can also be used to determine the type/brand of the mobile device. For example, iPhone, Android, or iPad. |
|
DDFS |
order.riskInquiry.device.deviceAttributes.firstSeenDateTime |
|
|
LANGUAGE |
order.riskInquiry.device.deviceAttributes.language |
|
|
TIMEZONE |
order.riskInquiry.device.deviceAttributes.timezoneOffset |
|
|
MOBILE_TYPE |
order.riskInquiry.device.deviceAttributes.mobileSdkType |
For mobile app integrations using the Device mobile SDKs, this field specifies the mobile operating system type. For browser-based orders, refer to order.riskInquiry.device.deviceAttributes.os. |
|
N/A |
order.riskInquiry.device.location |
|
|
N/A |
order.riskInquiry.device.location.areaCode |
|
|
N/A |
order.riskInquiry.device.location.city |
|
|
N/A |
order.riskInquiry.device.location.country |
|
|
COUNTRY |
order.riskInquiry.device.location.countryCode |
|
|
N/A |
order.riskInquiry.device.location.latitude |
|
|
N/A |
order.riskInquiry.device.location.longitude |
|
|
N/A |
order.riskInquiry.device.location.postalCode |
|
|
REGION |
order.riskInquiry.device.location.region |
|
|
N/A |
order.riskInquiry.device.location.regionCode |
|
|
N/A |
order.riskInquiry.device.tor |
|
|
N/A |
order.riskInquiry.segmentExecuted |
|
|
N/A |
order.riskInquiry.segmentExecuted.segment |
|
|
N/A |
order.riskInquiry.segmentExecuted.segment.id |
|
|
N/A |
order.riskInquiry.segmentExecuted.segment.name |
|
|
RULES_TRIGGERED |
order.riskInquiry.segmentExecuted.policiesExecuted |
|
|
RULE_ID_X |
order.riskInquiry.segmentExecuted.policiesExecuted.id |
|
|
RULE_DESCRIPTION_X |
order.riskInquiry.segmentExecuted.policiesExecuted.name |
|
|
N/A |
order.riskInquiry.segmentExecuted.policiesExecuted.outcome |
|
|
N/A |
order.riskInquiry.segmentExecuted.policiesExecuted.outcome.type |
|
|
N/A |
order.riskInquiry.segmentExecuted.policiesExecuted.outcome.value |
|
|
N/A |
order.fulfillment |
|
|
N/A |
order.fulfillment.fulfillmentId |
|
|
N/A |
order.fulfillment.merchantFulfillmentId |
|
|
N/A |
order.transactions.transactionId |
|
|
ERROR |
The HTTP error code and the response body will indicate the errors. |
Errors A required data point is misconfigured which prevented the risk analysis. |
|
ERROR_COUNT |
The HTTP error code and the response body will indicate the errors. |
Errors Number of errors the customer's RIS POST created. |
|
ERROR_N |
The HTTP error code and the response body will indicate the errors. |
Errors The error code displayed in RIS response. |
|
WARNING_COUNT |
N/A |
Errors Number of warnings the merchant RIS POST created. |
|
WARNING_N |
N/A |
Errors The warning code displayed in RIS response. |
|
BRND |
N/A |
Specifies the credit card brand when the payment type is credit card, such as Visa or MasterCard. |
|
DEVICE_LAYERS |
N/A |
Device (Intentionally Excluded) Five device layers representing the operating system. |
|
COOKIES |
N/A |
Device A flag to indicate if the device placing the order has cookies enabled or not. |
|
DSR |
N/A |
Device The device screen resolution. |
|
FLASH |
N/A |
Device (Obsolete – Intentionally Excluded) A flag to indicate if the device placing order has flash enabled or not. |
|
HTTP_COUNTRY |
N/A |
Device The home country the device owner has set in the device control panel. |
|
IP_IPAD |
N/A |
Device IP address of proxy:
|
|
PIP_IPAD |
N/A |
Device The pierced IP address:
|
|
JAVASCRIPT |
N/A |
Device A flag to indicate if the device placing order has JavaScript enabled or not. |
|
LOCALTIME |
N/A |
Device The local time of the device that the owner has set in the device’s Control Panel. |
|
MOBILE_FORWARDER |
N/A |
Device Determines if the mobile device is using a forwarder to process the carrier service. |
|
NETW |
N/A |
Device (Intentionally Excluded) Riskiest network type associated with persona within the last 14 days:
|
|
PC_REMOTE |
N/A |
Device Indicates if the device is enabled to use PC remote software. |
|
PROXY |
N/A |
Device Indicates if a proxy server is detected with this order. |
|
UAS |
N/A |
Device The user agent string. |
|
VOICE_DEVICE |
N/A |
Device Indicates if the mobile device is voice activated. |
|
CARDS |
N/A |
Persona Total number of credit cards associated to persona as seen by Equifax. |
|
GEOX |
N/A |
Persona The Persona related country with highest probability of fraud. |
|
REGN |
N/A |
Persona The region associated to the GEOX location. |
|
SCOR |
N/A |
Persona The Persona score. |
|
VELLO |
N/A |
Persona The quantity of orders seen from the Persona within last 14 days. AUTH field must be equal to A. |
|
VMAX |
N/A |
Persona The quantity of orders from the Persona within the most active six hour window in last 14 days. AUTH field must be equal to A. |
|
COUNTER_NAME_X |
N/A |
Rules/Counters |
|
COUNTER_VALUE_X |
N/A |
Rules/Counters |
|
COUNTERS_TRIGGERED |
N/A |
Rules/Counters Number of unique counter names triggered during rules evaluation. |
|
REASON_CODE |
N/A |
Rules/Counters The Custom Reason Code associated with Rule Action. |
|
3D_SECURE_MERCHANT_RESPONSE |
N/A |
3DS The 3D Secure recommendation based on policies defined within Equifax. |
|
PREVIOUSLY_WHITELISTED |
N/A |
3DS Related to a 3DS workflow. |
|
KYCF |
N/A |
Whether or not the system knows your customer flag. |
|
MERC |
N/A |
(Intentionally Excluded) Merchant ID assigned to the merchant by Equifax. |