Seller Item Listing

Seller Item Listing Integration

Key Fields:

• accountId: Customer's account UID in merchant's site
• eventTime: The time that the trigger event occurred in MILLISECONDS
• ConnectionInformation: Cyber intelligence data to analyze browsing behavior, device and connection quality such as IP address, user agent and data collected via JS / mobile SDK
• listedItems: Inventory change items

Please see the Customer Authentication Result API Reference section for more details.

Step 1: Front End Integration

In your dedicated Forter portal, you will receive a JavaScript snippet for both sandbox and production. For native mobile apps, you will receive links to download Forter's Native SDKs. You'll paste the JS script on the appropriate pages of your website or call mobile SDK methods on relevant mobile app screens so that it can load and asynchronously collect important behavioral data from your customer. The script or mobileUID generated by the mobile SDK will also generate a unique token for each user on your site that should be included in the Account Profile Access API Request Body.

Step 2: Account Item Listing API

accountItemListing API Request
Forter can provide a decision to approve a frictionless inventory change or suggest that Multi-Factor Auth if suspicious activity is detected. The relevant access type is denoted as the "UPDATE_PAYMENT" enum of the "accessRequestType" parameter in the request body. For the full API see, please see the Customer Account Profile Update API Reference section for more details.

{
  "accountId": "e520-ba9a-367-60b",
  "eventTime": 1415287568000,
  "connectionInformation": {
    "customerIP": "10.0.0.127",
    "userAgent": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36",
    "forterTokenCookie": "2315688945984"
  },
  "channelType": "WEB",
  "accountOwner": {
    "email": "[email protected]",
    "accountId": "e520-ba9a-367-60b",
    "created": 1415273168
  },
 "listedItems": [
    {
      "basicItemData": {
        "category": "Apparel and accessories",
        "discount": {
          "couponCodeUsed": "FATHERSDAY2015",
          "couponDiscountAmount": {
            "amountLocalCurrency": "105.55",
            "amountUSD": "99.95",
            "currency": "CAD"
          },
          "discountType": "COUPON"
        },
        "name": "White GenericBrand handbag",
        "price": {
          "amountLocalCurrency": "105.55",
          "amountUSD": "99.95",
          "currency": "CAD"
        },
        "productId": "Ag54352R7768kkO",
        "productIdType": "SKU",
        "quantity": 1,
        "secondaryProductId": "2h8331lg4692B45p",
        "secondaryProductIdType": "ISBN",
        "type": "TANGIBLE",
        "value": {
          "amountLocalCurrency": "105.55",
          "amountUSD": "99.95",
          "currency": "CAD"
        }
      }
    }
 ]

}

Seller Item Listing API Response
The Account Profile Access API response will include the Forter decision and potential recommendations, as well as a correlation ID that should be stored and used when the merchant provides additional updates (e.g. result of MFA)

Key Fields:

forterDecision: The latest Forter decision regarding the attempted action. Said fields may hold one of various options:

• "APPROVE" for approved signup requests, where user should be allowed to register for a new accounts;
• "DECLINE" for declined signup requests, where user should be declined from registering for new accounts;
• "VERIFICATION_REQUIRED" for signup requests, where user should be triggered an additional verification (via email, sms, etc.,;
• "NOT_REVIEWED".

recommendation: A specific recommendation for an action that might help the customer to complete their transaction/action (e.g. verify phone via SMS, verify via push notification, verify email, perform a 3DS check, etc.)

{
  "forterDecision": "DECLINE",
  "decisionReason": "",
  "accountId": "e520-ba9a-367-60b",
  "correlationId": "HGJ7512345H3DE",
  "recommendation": "MFA"
}