Seller item listing - API Reference
Seller item listing
POST
Send information about a seller's new inventory in order to receive a fraud or abuse decision.
Credentials
HTTP Basic basicAuth
Path Parameters
id: string *
Header Parameters
api-version: string *x-forter-siteid: string *
Body Parameters
body:accountItemListingRequest*
Description
Send information about a seller's new inventory in order to receive a fraud or abuse decision.
- accountData: object
All Of- AccountData
accountId: string *- additionalInformation: object
All Of- GeneralPayloadMap
channelType: string<WEB | PHONE | DYNAMIC_PHONE | MOBILE | MOBILE_IN_STORE | IOS | ANDROID | WAP | STORE | MERCHANT_EMPLOYEE | MAIL_ORDER | AUTOMATIC_RENEWAL_OR_INSTALLMENT_PAYMENT | MERCHANT_INITIATED | UNKNOWN | POS | API_ONLY | PERSONAL_POS | PHONE_LINK>nullable- connectionInformation:
ConnectionInformation* eventTime: number *listedItems:Item[]*- merchantIdentifiers: object
All Of- MerchantIdentifiers +
Responses
200
Example adaptiveAuthAccountsResponse
{
"accountId": "e520-ba9a-367-60b",
"correlationId": "HGJ7512345H3DE",
"decisionReason": "",
"forterDecision": "",
"merchantPolicyId": "0ee8ba28a8654c659addbae9253b707c",
"recommendation": "",
"verificationMethod": {
"correlationId": "HGJ7512345H3DE",
"status": "FRICTIONLESS",
"statusCode": "100",
"statusMessage": "Verification code sent",
"type": "THREE_DS",
"verificationId": "345H3DEHGJ7512",
"verificationSpecificData": {
"ThreeDS": {},
"email": {},
"phone": {}
}
}
}
400 Bad Request (Often missing a required parameter)
401 Unauthorized (No valid API key provided)
404 Not Found (The requested item doesn't exist)
500 Server Error (Something went wrong on Forter's end)
Request
Curl
curl --request POST \
--url https://api.forter-secure.com/v2/accounts/item-listing/{id} \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--header 'api-version: 10.1' \
--header 'x-forter-siteid: a1b2c3d4e5f6' \
--data-raw '{
"accountData": {
"additionalVerificationDocuments": {
"documentSource": "UPLOADED_FILE",
"documentType": "Passport",
"documentVerificationServiceResponsePayload": {}
},
"addressesInAccount": [
{
"address1": "235 Montgomery st.",
"city": "San Francisco",
"country": "US",
"savedData": {
"usedSavedData": true
}
}
],
"customerEngagement": {
"communityPostsWritten": {
"updateTimes": {
"creationTime": 1448549922
}
},
"invites": [
{"type": "SENT"}
],
"likedItems": {
"updateTimes": {
"creationTime": 1448549922
}
},
"messagesReceived": {
"updateTimes": {
"creationTime": 1448549922
}
},
"messagesSent": {
"updateTimes": {
"creationTime": 1448549922
}
},
"newsletters": {
"updateTimes": {
"creationTime": 1448549922
}
},
"reviewsWritten": {
"updateTimes": {
"creationTime": 1448549922
}
},
"savedLocations": [{
"latitude": 32.07332,
"longitude": 34.79675,
"source": "MOBILE"
}],
"sharedItems": {
"updateTimes": {
"creationTime": 1448549922
}
},
"wishlist": {
"updateTimes": {
"creationTime": 1448549922
}
}
},
"emailsInAccount": [
{
"email": "john_s@test.com",
"emailVerification": {
"sent": true,
"verified": false
}
}
],
"phonesInAccount": [
{
"phone": "15557654321",
"smsVerified": {
"sent": true,
"verified": false
}
}
],
"ratingAsBuyer": {
"score": "4.5",
"source": "yelp",
"type": "INTERNAL_PEERS"
}
},
"accountId": "e520-ba9a-367-60b",
"additionalInformation": {},
"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"
},
"eventTime": 1415287568000,
"listedItems": [
{
"basicItemData": {
"discount": {
"couponCodeUsed": "FATHERSDAY2015",
"couponDiscountAmount": {}
},
"name": "White GenericBrand handbag",
"price": {},
"quantity": 1,
"type": "TANGIBLE"
},
"beneficiaries": [
{
"additionalVerificationDocuments": {
"documentSource": "UPLOADED_FILE",
"documentType": "Passport",
"documentVerificationServiceResponsePayload": {}
},
"address": {
"address1": "235 Montgomery st.",
"city": "San Francisco",
"country": "US",
"savedData": {
"usedSavedData": true
}
},
"bankAccount": {
"paymentGatewayData": {}
},
"comments": {},
"cryptoWallet": {
"cryptoWalletType": "EXTERNAL"
},
"personalDetails": {},
"phone": [{
"phone": "15557654321",
"smsVerified": {
"sent": true,
"verified": false
}
}]
}
],
"deliveryDetails": {
"deliveryMethod": "USPS - Ground Mail",
"deliveryPrice": {},
"deliveryType": "PHYSICAL"
},
"itemReturnData": {
"posDetails": {
"address": {
"address1": "235 Montgomery st.",
"city": "San Francisco",
"country": "US",
"savedData": {
"usedSavedData": true
}
},
"cardEntryMethod": "SCANNED",
"cashierId": "fgh5e0rr48923d",
"departmentId": "e0r4592356fds",
"storeBusinessUnit": "Full Line",
"storeId": "2356fdse0rr489",
"storeName": "Union Square",
"workStationId": "923e5th5e0rr48"
},
"returnStatusLog": {}
},
"itemSpecificData": {
"accommodation": {
"accommodationAddress": {
"address1": "235 Montgomery st.",
"city": "San Francisco",
"country": "US",
"savedData": {
"usedSavedData": true
}
},
"duration": {
"endDate": "2014-11-15",
"startDate": "2014-10-28"
},
"location": {},
"numberOfGuests": 2,
"rating": [{
"score": "4.5",
"source": "yelp",
"type": "INTERNAL_PEERS"
}],
"type": "HOTEL"
},
"cryptocurrency": {},
"digitalGoodsAndServices": {
"duration": {
"endDate": "2014-11-15",
"startDate": "2014-10-28"
},
"webHosting": {
"domains": []
}
},
"food": {
"restaurantAddress": {
"address1": "235 Montgomery st.",
"city": "San Francisco",
"country": "US",
"savedData": {
"usedSavedData": true
}
},
"tipAmount": {}
},
"gaming": {
"gameItemAmount": 1000,
"gameName": "WorldOfSampleGamecrat"
},
"physicalGoods": {},
"professionalServices": {
"tipAmount": {}
},
"ticketsAndEvents": {
"eventLocation": {
"address1": "235 Montgomery st.",
"city": "San Francisco",
"country": "US",
"savedData": {
"usedSavedData": true
}
},
"eventName": "FIFA World Cup Final"
},
"transport": [{
"driverDetails": {
"availableFundsForWithdrawal": {},
"ratingAsBuyer": {
"score": "4.5",
"source": "yelp",
"type": "INTERNAL_PEERS"
},
"ratingAsSeller": {
"score": "4.5",
"source": "yelp",
"type": "INTERNAL_PEERS"
},
"sellerAccountCreationDate": 1415273168,
"sellerLastLoginIP": {
"ip": "10.0.0.128",
"updateTimes": {}
},
"sellerPersonalDetails": {},
"sellerRegistrationIP": {
"ip": "10.0.0.128",
"updateTimes": {}
}
},
"duration": {
"startTime": 1412345911
},
"endPoint": {
"address": {
"address1": "235 Montgomery st.",
"city": "San Francisco",
"country": "US",
"savedData": {}
},
"exactLocation": {
"latitude": 32.07332,
"longitude": 34.79675,
"source": "MOBILE"
},
"locationName": {},
"roughLocation": {},
"savedLocation": {
"usedSavedData": true
}
},
"locationAtTimeOfReservation": {
"address": {
"address1": "235 Montgomery st.",
"city": "San Francisco",
"country": "US",
"savedData": {}
},
"exactLocation": {
"latitude": 32.07332,
"longitude": 34.79675,
"source": "MOBILE"
},
"locationName": {},
"roughLocation": {},
"savedLocation": {
"usedSavedData": true
}
},
"startPoint": {
"address": {
"address1": "235 Montgomery st.",
"city": "San Francisco",
"country": "US",
"savedData": {}
},
"exactLocation": {
"latitude": 32.07332,
"longitude": 34.79675,
"source": "MOBILE"
},
"locationName": {},
"roughLocation": {},
"savedLocation": {
"usedSavedData": true
}
},
"type": "AIR_TRAVEL"
}]
},
"seller": {
"sellerDetails": {
"availableFundsForWithdrawal": {},
"ratingAsBuyer": {
"score": "4.5",
"source": "yelp",
"type": "INTERNAL_PEERS"
},
"ratingAsSeller": {
"score": "4.5",
"source": "yelp",
"type": "INTERNAL_PEERS"
},
"sellerAccountCreationDate": 1415273168,
"sellerLastLoginIP": {
"ip": "10.0.0.128",
"updateTimes": {"creationTime": 1448549922}
},
"sellerPersonalDetails": {},
"sellerRegistrationIP": {
"ip": "10.0.0.128",
"updateTimes": {"creationTime": 1448549922}
}
}
},
"shopifyAdditionalItemData": {
"properties": {}
}
}
],
"merchantIdentifiers": {}
}'