---
title: 補償リクエスト
slug: DgnDmGo4WZMF2ob0IdLWb
createdAt: 2025-08-12T21:15:13.774Z
---
{
"id": "kdT5wcBLZri04ewBahYhk",
"type": "api-oas-v2",
"data": {
"method": "POST",
"url": "https://api.forter-secure.com/v2/unified-compensation-request/{id}",
"servers": [
{
"url": "https://api.forter-secure.com/v2/unified-compensation-request/{id}"
}
],
"name": "Compensation request",
"description": "Send information about a customer-initiated request for compensation, such as a refund or a reship, in order to receive a fraud or abuse decision.\nThe request can be made on an order level or at the item level. The response may also include recommendations based on your abuse prevention policies.
",
"contentType": "application/json",
"request": {
"pathParameters": [
{
"kind": "required",
"name": "id",
"type": "string",
"description": ""
}
],
"headerParameters": [
{
"kind": "required",
"name": "api-version",
"type": "string",
"example": "10.1",
"description": "Specify the version of the API to target.",
"default": "10.1"
},
{
"kind": "required",
"name": "x-forter-siteid",
"type": "string",
"example": "a1b2c3d4e5f6",
"description": "Forter-assigned ID for your account. Note that your Site ID for your test site is different from your production site.
",
"default": "8b47c6d423ba"
},
{
"kind": "required",
"name": "Authorization",
"type": "string",
"example": "Basic ",
"description": "Basic Authentiation in the form of a username and password. Use the API Key as the username and leave the password empty.",
"default": "Basic "
}
],
"queryParameters": [],
"bodyDataParameters": [
{
"kind": "required",
"name": "body",
"type": "object",
"description": "Send information about a customer-initiated request for compensation, such as a refund or a reship, in order to receive a fraud or abuse decision. \nThe request can be made on an order level or at the item level. The response may also include recommendations based on your abuse prevention policies.",
"customType": "unifiedCompensationRequestRequest",
"schema": [
{
"name": "accountId",
"kind": "required",
"type": "string",
"description": "Customer's account UID in merchant's site. If the compensation request is from a guest account then this field should be populated with the original order id ending with the suffix '_GUEST'.",
"example": "",
"default": "e520-ba9a-367-60b"
},
{
"name": "additionalEventIdentifiers",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "AdditionalAccountEventIdentifiers",
"description": "",
"modelRef": "#/components/schemas/AdditionalAccountEventIdentifiers",
"schema": []
}
],
"schema": []
},
{
"name": "additionalInformation",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "GeneralPayloadMap",
"description": "",
"modelRef": "#/components/schemas/GeneralPayloadMap",
"schema": []
}
],
"schema": []
},
{
"name": "compensationRequest",
"kind": "required",
"type": "object",
"description": "Details of compensation request (type of compensation requested, items for which compensation is requested, etc.)",
"modelRef": "#/components/schemas/CompensationRequest",
"customType": "CompensationRequest",
"schema": [
{
"name": "initiationType",
"kind": "required",
"type": "string",
"description": "What channel did the customer use to initiate the request for compensation",
"example": "",
"default": "CALL_CENTER"
},
{
"name": "items",
"kind": "required",
"type": "array",
"description": "A list of all items for which compensation is being requested",
"modelRef": "#/components/schemas/CompensationItem",
"customType": "CompensationItem[]",
"schema": [
{
"name": "basicItemData",
"kind": "required",
"type": "object",
"description": "General data regarding item such as name, price, etc.",
"modelRef": "#/components/schemas/BasicItemData",
"customType": "BasicItemData",
"schema": [
{
"name": "category",
"kind": "optional",
"type": "string",
"description": "Item category",
"example": "",
"default": "Apparel and accessories"
},
{
"name": "discount",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "Discount",
"description": "",
"modelRef": "#/components/schemas/Discount",
"schema": [
{
"name": "couponCodeUsed",
"kind": "required",
"type": "string",
"description": "Coupon code used",
"example": "",
"default": "FATHERSDAY2015"
},
{
"name": "couponDiscountAmount",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "Amount",
"description": "",
"modelRef": "#/components/schemas/Amount",
"schema": [
{
"name": "amountLocalCurrency",
"kind": "optional",
"type": "string",
"description": "Transaction amount in currency chosen by the buyer",
"example": "",
"default": "105.55"
},
{
"name": "amountUSD",
"kind": "optional",
"type": "string",
"description": "Transaction amount in USD",
"example": "",
"default": "99.95"
},
{
"name": "currency",
"kind": "optional",
"type": "string",
"description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code",
"example": "",
"default": "CAD"
}
]
}
],
"schema": []
},
{
"name": "couponDiscountPercent",
"kind": "optional",
"type": "string",
"description": "Coupon discount amount",
"example": ""
}
]
}
],
"schema": []
},
{
"name": "name",
"kind": "required",
"type": "string",
"description": "Item name",
"example": "",
"default": "White GenericBrand handbag"
},
{
"name": "price",
"kind": "required",
"type": "object",
"description": "Final amount due for purchase, after all discounts and promotions",
"modelRef": "#/components/schemas/Amount",
"customType": "Amount",
"schema": [
{
"name": "amountLocalCurrency",
"kind": "optional",
"type": "string",
"description": "Transaction amount in currency chosen by the buyer",
"example": "",
"default": "105.55"
},
{
"name": "amountUSD",
"kind": "optional",
"type": "string",
"description": "Transaction amount in USD",
"example": "",
"default": "99.95"
},
{
"name": "currency",
"kind": "optional",
"type": "string",
"description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code",
"example": "",
"default": "CAD"
}
]
},
{
"name": "productId",
"kind": "optional",
"type": "string",
"description": "Unique identifier for item that is common to all identical items (such as SKU, ISBN, etc.)",
"example": "",
"default": "Ag54352R7768kkO"
},
{
"name": "quantity",
"kind": "required",
"type": "number",
"description": "Item quantity",
"example": "",
"default": 1
},
{
"name": "type",
"kind": "required",
"type": "string",
"description": "Tangible if physical item, non-tangible if any other product",
"example": "",
"default": "TANGIBLE"
}
]
},
{
"name": "itemCompensationData",
"kind": "required",
"type": "object",
"description": "Data relating to the return of the item",
"modelRef": "#/components/schemas/CompensationData",
"customType": "CompensationData",
"schema": [
{
"name": "compensationTypeRequested",
"kind": "optional",
"type": "string",
"description": "Indicates whether the customer requested a refund, store credit, replacement etc.",
"example": "",
"default": "REFUND"
},
{
"name": "initiationTime",
"kind": "required",
"type": "number",
"description": "The time that the customer initiated the request for compensation in MILLISECONDS since unix epoch (Jan 1, 1970)",
"example": "",
"default": 1415287568000
},
{
"name": "internalReasonCategory",
"kind": "optional",
"type": "string",
"description": "The reason for the request as defined by the merchant",
"example": "",
"default": "defective item"
},
{
"name": "reasonCategory",
"kind": "optional",
"type": "string",
"description": "Reason for compensation request",
"example": "",
"default": "CHANGED_MY_MIND"
},
{
"name": "requestedReturnType",
"kind": "required",
"type": "string",
"description": "Method of return requested by customer (or the request to not return item at all)",
"example": "",
"default": "SHIP_TO_WAREHOUSE"
}
]
}
]
},
{
"name": "orderCompensationData",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "CompensationData",
"description": "",
"modelRef": "#/components/schemas/CompensationData",
"schema": [
{
"name": "compensationTypeRequested",
"kind": "optional",
"type": "string",
"description": "Indicates whether the customer requested a refund, store credit, replacement etc.",
"example": "",
"default": "REFUND"
},
{
"name": "initiationTime",
"kind": "required",
"type": "number",
"description": "The time that the customer initiated the request for compensation in MILLISECONDS since unix epoch (Jan 1, 1970)",
"example": "",
"default": 1415287568000
},
{
"name": "internalReasonCategory",
"kind": "optional",
"type": "string",
"description": "The reason for the request as defined by the merchant",
"example": "",
"default": "defective item"
},
{
"name": "reasonCategory",
"kind": "optional",
"type": "string",
"description": "Reason for compensation request",
"example": "",
"default": "CHANGED_MY_MIND"
},
{
"name": "requestedReturnType",
"kind": "required",
"type": "string",
"description": "Method of return requested by customer (or the request to not return item at all)",
"example": "",
"default": "SHIP_TO_WAREHOUSE"
}
]
}
],
"schema": []
},
{
"name": "totalRequestedAmount",
"kind": "required",
"type": "object",
"description": "Total amount of the compensation requested by customer",
"modelRef": "#/components/schemas/Amount",
"customType": "Amount",
"schema": [
{
"name": "amountLocalCurrency",
"kind": "optional",
"type": "string",
"description": "Transaction amount in currency chosen by the buyer",
"example": "",
"default": "105.55"
},
{
"name": "amountUSD",
"kind": "optional",
"type": "string",
"description": "Transaction amount in USD",
"example": "",
"default": "99.95"
},
{
"name": "currency",
"kind": "optional",
"type": "string",
"description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code",
"example": "",
"default": "CAD"
}
]
}
]
},
{
"name": "connectionInformation",
"kind": "required",
"type": "object",
"description": "Connection information about the customer typically found in the HTTP request header, if the compensation was initiated online",
"modelRef": "#/components/schemas/ConnectionInformation",
"customType": "ConnectionInformation",
"schema": [
{
"name": "checkoutToolsSessionId",
"kind": "optional",
"type": "string",
"description": "CheckoutToolsSessionId received from the SDK",
"example": "",
"default": "HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd"
},
{
"name": "customerIP",
"kind": "required",
"type": "string",
"description": "Customer IP address in IPv4 or IPv6 format. If missing should be populated with 127.0.0.1",
"example": "",
"default": "10.0.0.127"
},
{
"name": "forterMobileUID",
"kind": "optional",
"type": "string",
"description": "mobile UID. The device identifier such as IMEI in android or identifier for vendor in iOS. This should match the deviceId sent via the mobile events API (for mobile transactions only)",
"example": "",
"default": "6429751237891"
},
{
"name": "forterTokenCookie",
"kind": "optional",
"type": "string",
"description": "Forter token cookie from request headers",
"example": "",
"default": "249453te8tbf9355186fet0ken547b95_2786972955236__UDE52-n5_8dg"
},
{
"name": "merchantDeviceIdentifier",
"kind": "optional",
"type": "string",
"description": "A unique device identifier generated by merchant",
"example": "",
"default": "HGJ7512345H3"
},
{
"name": "merchantProvidedSessionId",
"kind": "optional",
"type": "string",
"description": "An identifier of the merchant session",
"example": "",
"default": "HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd"
},
{
"name": "userAgent",
"kind": "required",
"type": "string",
"description": "Customer's User agent",
"example": "",
"default": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36"
}
]
},
{
"name": "eventId",
"kind": "required",
"type": "string",
"description": "Unique identifier of this compensation request",
"example": "",
"default": "r48987fgdse0r"
},
{
"name": "eventTime",
"kind": "required",
"type": "number",
"description": "The time that the trigger event occurred in MILLISECONDS since unix epoch (Jan 1, 1970)",
"example": "",
"default": 1415287568000
},
{
"name": "hasProofOfPurchase",
"kind": "optional",
"type": "boolean",
"description": "Whether the user has a proof of purchase",
"example": "",
"default": true
},
{
"name": "isGuestAccount",
"kind": "required",
"type": "boolean",
"description": "Boolean field indicating if account is a guest account.",
"example": "",
"default": false
},
{
"name": "merchantAgentData",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "MerchantAgentData",
"description": "",
"modelRef": "#/components/schemas/MerchantAgentData",
"schema": [
{
"name": "merchantAgentId",
"kind": "optional",
"type": "string",
"description": "Unique identifier of the agent processing the customer's request",
"example": "",
"default": "HG36885TZ"
},
{
"name": "merchantAgentName",
"kind": "optional",
"type": "string",
"description": "Name of the agent processing the customer's request",
"example": "",
"default": "John Smith"
}
]
}
],
"schema": []
},
{
"name": "merchantIdentifiers",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "MerchantIdentifiers",
"description": "",
"modelRef": "#/components/schemas/MerchantIdentifiers",
"schema": [
{
"name": "merchantDomain",
"kind": "optional",
"type": "string",
"description": "Use if merchant operates several sites (such as a regular site and a related discount brand)",
"example": "",
"default": "HandbagsExpressDiscounts.com"
},
{
"name": "merchantName",
"kind": "optional",
"type": "string",
"description": "Use if merchant operates several sites (such as a regular site and a related discount brand)",
"example": "",
"default": "Handbags Express Discounts"
}
]
}
],
"schema": []
},
{
"name": "originalOrderId",
"kind": "required",
"type": "string",
"description": "Unique order/transaction identifier for which compensation is being requested in this compensation event. Note that Forter treats this ID as case-insensitive; Order123 and ORDER123 will be identified as the same order.",
"example": "",
"default": "2356fdse0rr489"
},
{
"name": "status",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "CompensationStatus",
"description": "",
"modelRef": "#/components/schemas/CompensationStatus",
"schema": [
{
"name": "hasProofOfPurchase",
"kind": "optional",
"type": "boolean",
"example": ""
},
{
"name": "itemStatus",
"kind": "required",
"type": "array",
"description": "A list of all items for which compensation was requested",
"modelRef": "#/components/schemas/ItemCompensationStatus",
"customType": "ItemCompensationStatus[]",
"schema": [
{
"name": "basicItemData",
"kind": "required",
"type": "object",
"description": "General data regarding item such as name, price, etc.",
"modelRef": "#/components/schemas/BasicItemData",
"customType": "BasicItemData",
"schema": [
{
"name": "category",
"kind": "optional",
"type": "string",
"description": "Item category",
"example": "",
"default": "Apparel and accessories"
},
{
"name": "discount",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "Discount",
"description": "",
"modelRef": "#/components/schemas/Discount",
"schema": [
{
"name": "couponCodeUsed",
"kind": "required",
"type": "string",
"description": "Coupon code used",
"example": "",
"default": "FATHERSDAY2015"
},
{
"name": "couponDiscountAmount",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "Amount",
"description": "",
"modelRef": "#/components/schemas/Amount",
"schema": [
{
"name": "amountLocalCurrency",
"kind": "optional",
"type": "string",
"description": "Transaction amount in currency chosen by the buyer",
"example": "",
"default": "105.55"
},
{
"name": "amountUSD",
"kind": "optional",
"type": "string",
"description": "Transaction amount in USD",
"example": "",
"default": "99.95"
},
{
"name": "currency",
"kind": "optional",
"type": "string",
"description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code",
"example": "",
"default": "CAD"
}
]
}
],
"schema": []
},
{
"name": "couponDiscountPercent",
"kind": "optional",
"type": "string",
"description": "Coupon discount amount",
"example": ""
}
]
}
],
"schema": []
},
{
"name": "name",
"kind": "required",
"type": "string",
"description": "Item name",
"example": "",
"default": "White GenericBrand handbag"
},
{
"name": "price",
"kind": "required",
"type": "object",
"description": "Final amount due for purchase, after all discounts and promotions",
"modelRef": "#/components/schemas/Amount",
"customType": "Amount",
"schema": [
{
"name": "amountLocalCurrency",
"kind": "optional",
"type": "string",
"description": "Transaction amount in currency chosen by the buyer",
"example": "",
"default": "105.55"
},
{
"name": "amountUSD",
"kind": "optional",
"type": "string",
"description": "Transaction amount in USD",
"example": "",
"default": "99.95"
},
{
"name": "currency",
"kind": "optional",
"type": "string",
"description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code",
"example": "",
"default": "CAD"
}
]
},
{
"name": "productId",
"kind": "optional",
"type": "string",
"description": "Unique identifier for item that is common to all identical items (such as SKU, ISBN, etc.)",
"example": "",
"default": "Ag54352R7768kkO"
},
{
"name": "quantity",
"kind": "required",
"type": "number",
"description": "Item quantity",
"example": "",
"default": 1
},
{
"name": "type",
"kind": "required",
"type": "string",
"description": "Tangible if physical item, non-tangible if any other product",
"example": "",
"default": "TANGIBLE"
}
]
},
{
"name": "statusData",
"kind": "required",
"type": "object",
"description": "Data relating to the return of the item",
"modelRef": "#/components/schemas/ItemCompensationStatusData",
"customType": "ItemCompensationStatusData",
"schema": [
{
"name": "compensationTypeGranted",
"kind": "required",
"type": "string",
"description": "Indicates whether the customer was granted a refund, store credit, replacement etc.",
"example": "",
"default": "REFUND"
},
{
"name": "internalReasonCategory",
"kind": "optional",
"type": "string",
"description": "The reason for the request as defined by the merchant",
"example": "",
"default": "defective item"
},
{
"name": "reasonCategory",
"kind": "required",
"type": "string",
"description": "Reason for compensation request",
"example": "",
"default": "CHANGED_MY_MIND"
},
{
"name": "returnCondition",
"kind": "optional",
"type": "string",
"description": "Condition of the item returned",
"example": "",
"default": "DAMAGED"
},
{
"name": "returnMethodGranted",
"kind": "required",
"type": "string",
"description": "Method of return granted to customer",
"example": "",
"default": "SHIP_TO_WAREHOUSE"
},
{
"name": "statusLog",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "CompensationStatusLog",
"description": "",
"modelRef": "#/components/schemas/CompensationStatusLog",
"schema": [
{
"name": "arrivedToWarehouseTime",
"kind": "optional",
"type": "number",
"description": "Time returned items arrived to the merchant's warehouse",
"example": "",
"default": 1420070400000
},
{
"name": "initiationTime",
"kind": "optional",
"type": "number",
"description": "The time that the customer initiated the request for compensation in MILLISECONDS since unix epoch (Jan 1, 1970)",
"example": "",
"default": 1415287568000
},
{
"name": "initiationType",
"kind": "optional",
"type": "string",
"description": "What channel did the customer use to initiate the request for compensation",
"example": "",
"default": "CALL_CENTER"
},
{
"name": "shippedByCustomerTime",
"kind": "optional",
"type": "number",
"description": "Time returned items were shipped by the customer",
"example": "",
"default": 1420070400000
}
]
}
],
"schema": []
},
{
"name": "updatedStatus",
"kind": "required",
"type": "string",
"description": "The updated compensation request status",
"example": "",
"default": "ACCEPTED_BY_MERCHANT"
}
]
}
]
},
{
"name": "merchantAgentData",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "MerchantAgentData",
"description": "",
"modelRef": "#/components/schemas/MerchantAgentData",
"schema": [
{
"name": "merchantAgentId",
"kind": "optional",
"type": "string",
"description": "Unique identifier of the agent processing the customer's request",
"example": "",
"default": "HG36885TZ"
},
{
"name": "merchantAgentName",
"kind": "optional",
"type": "string",
"description": "Name of the agent processing the customer's request",
"example": "",
"default": "John Smith"
}
]
}
],
"schema": []
},
{
"name": "replacementOrderId",
"kind": "optional",
"type": "string",
"description": "Unique order/transaction identifier for a replacement order issued by the merchant in response to this request",
"example": "",
"default": "2356fdse0rr489"
},
{
"name": "shippingRefunded",
"kind": "optional",
"type": "boolean",
"description": "Indicates whether merchant reimbursed the customer for shipping expenses",
"example": ""
},
{
"name": "shippingRefundedAmount",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "Amount",
"description": "",
"modelRef": "#/components/schemas/Amount",
"schema": [
{
"name": "amountLocalCurrency",
"kind": "optional",
"type": "string",
"description": "Transaction amount in currency chosen by the buyer",
"example": "",
"default": "105.55"
},
{
"name": "amountUSD",
"kind": "optional",
"type": "string",
"description": "Transaction amount in USD",
"example": "",
"default": "99.95"
},
{
"name": "currency",
"kind": "optional",
"type": "string",
"description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code",
"example": "",
"default": "CAD"
}
]
}
],
"schema": []
},
{
"name": "statusData",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "ItemCompensationStatusData",
"description": "",
"modelRef": "#/components/schemas/ItemCompensationStatusData",
"schema": [
{
"name": "compensationTypeGranted",
"kind": "required",
"type": "string",
"description": "Indicates whether the customer was granted a refund, store credit, replacement etc.",
"example": "",
"default": "REFUND"
},
{
"name": "internalReasonCategory",
"kind": "optional",
"type": "string",
"description": "The reason for the request as defined by the merchant",
"example": "",
"default": "defective item"
},
{
"name": "reasonCategory",
"kind": "required",
"type": "string",
"description": "Reason for compensation request",
"example": "",
"default": "CHANGED_MY_MIND"
},
{
"name": "returnCondition",
"kind": "optional",
"type": "string",
"description": "Condition of the item returned",
"example": "",
"default": "DAMAGED"
},
{
"name": "returnMethodGranted",
"kind": "required",
"type": "string",
"description": "Method of return granted to customer",
"example": "",
"default": "SHIP_TO_WAREHOUSE"
},
{
"name": "statusLog",
"kind": "optional",
"type": "object",
"complexType": "allOf",
"complexItems": [
{
"name": "CompensationStatusLog",
"description": "",
"modelRef": "#/components/schemas/CompensationStatusLog",
"schema": [
{
"name": "arrivedToWarehouseTime",
"kind": "optional",
"type": "number",
"description": "Time returned items arrived to the merchant's warehouse",
"example": "",
"default": 1420070400000
},
{
"name": "initiationTime",
"kind": "optional",
"type": "number",
"description": "The time that the customer initiated the request for compensation in MILLISECONDS since unix epoch (Jan 1, 1970)",
"example": "",
"default": 1415287568000
},
{
"name": "initiationType",
"kind": "optional",
"type": "string",
"description": "What channel did the customer use to initiate the request for compensation",
"example": "",
"default": "CALL_CENTER"
},
{
"name": "shippedByCustomerTime",
"kind": "optional",
"type": "number",
"description": "Time returned items were shipped by the customer",
"example": "",
"default": 1420070400000
}
]
}
],
"schema": []
},
{
"name": "updatedStatus",
"kind": "required",
"type": "string",
"description": "The updated compensation request status",
"example": "",
"default": "ACCEPTED_BY_MERCHANT"
}
]
}
],
"schema": []
},
{
"name": "totalGrantedAmount",
"kind": "required",
"type": "object",
"description": "Total amount of the compensation granted to customer (excluding shippingRefundedAmount)",
"modelRef": "#/components/schemas/Amount",
"customType": "Amount",
"schema": [
{
"name": "amountLocalCurrency",
"kind": "optional",
"type": "string",
"description": "Transaction amount in currency chosen by the buyer",
"example": "",
"default": "105.55"
},
{
"name": "amountUSD",
"kind": "optional",
"type": "string",
"description": "Transaction amount in USD",
"example": "",
"default": "99.95"
},
{
"name": "currency",
"kind": "optional",
"type": "string",
"description": "Transaction currency chosen by the buyer, 3-letter ISO-4217 format currency code",
"example": "",
"default": "CAD"
}
]
}
]
}
],
"schema": []
}
],
"modelRef": "#/components/schemas/unifiedCompensationRequestRequest",
"isExpanded": true
}
],
"formDataParameters": [],
"oAuthParameters": [
{
"id": "basicAuth",
"name": "basicAuth",
"kind": "optional",
"type": "http",
"scheme": "basic"
}
]
},
"responses": [
{
"statusCode": "200",
"description": "Example unifiedCompensationRequestResponse",
"jsonExample": "",
"isExpanded": true,
"schema": [
{
"kind": "optional",
"type": "object",
"description": "The response object of a forter compensation request call",
"customType": "unifiedCompensationRequestResponse",
"schema": [
{
"name": "correlationId",
"kind": "required",
"type": "string",
"description": "A Forter unique identifier that was provided as part of a Forter API response. Used to correlate between the compensation request event and final status update",
"example": "",
"default": "HGJ7512345H3DE"
},
{
"name": "decisionReason",
"kind": "required",
"type": "string",
"example": "",
"default": ""
},
{
"name": "forterDecision",
"kind": "required",
"type": "string",
"description": "The message containing the decision",
"example": "",
"default": "approve"
},
{
"name": "merchantPolicyId",
"kind": "required",
"type": "string",
"description": "UID of the custom policy created in Forter's Policies tool that resulted in this decision",
"example": "",
"default": "0ee8ba28a8654c659addbae9253b707c"
},
{
"name": "recommendations",
"kind": "required",
"type": "array",
"description": "Forter's recommendations for the optimal way of proceeding with the compensation request",
"example": "",
"default": [],
"itemType": "string",
"customType": "string[]",
"itemExample": "",
"itemDefault": ""
},
{
"name": "status",
"kind": "required",
"type": "string",
"description": "Status of the request processing",
"example": "",
"default": "success"
}
],
"modelRef": "#/components/schemas/unifiedCompensationRequestResponse",
"isExpanded": true
}
]
},
{
"statusCode": "400",
"description": "Bad Request (Often missing a required parameter)",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "401",
"description": "Unauthorized (No valid API key provided)",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "404",
"description": "Not Found (The requested item doesn't exist)",
"jsonExample": "",
"isExpanded": true
},
{
"statusCode": "500",
"description": "Server Error (Something went wrong on Forter's end)",
"jsonExample": "",
"isExpanded": true
}
],
"hasXCodeSamples": false,
"examples": {
"languages": [
{
"id": "example-0-curl",
"language": "curl",
"label": "cURL",
"code": "curl --request POST \\\n --url https://api.forter-secure.com/v2/unified-compensation-request/{id} \\\n --header 'accept: application/json' \\\n --header 'content-type: application/json' \\\n --header 'api-version: 10.1' \\\n --header 'x-forter-siteid: 8b47c6d423ba' \\\n --header 'authorization: Basic ' \\\n --data '{\n \"accountId\": \"e520-ba9a-367-60b\",\n \"additionalEventIdentifiers\": {},\n \"additionalInformation\": {},\n \"compensationRequest\": {\n \"initiationType\": \"CALL_CENTER\",\n \"items\": [\n {\n \"basicItemData\": {\n \"category\": \"Apparel and accessories\",\n \"discount\": {\n \"couponCodeUsed\": \"FATHERSDAY2015\",\n \"couponDiscountAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"name\": \"White GenericBrand handbag\",\n \"price\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"productId\": \"Ag54352R7768kkO\",\n \"quantity\": 1,\n \"type\": \"TANGIBLE\"\n },\n \"itemCompensationData\": {\n \"compensationTypeRequested\": \"REFUND\",\n \"initiationTime\": 1415287568000,\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"requestedReturnType\": \"SHIP_TO_WAREHOUSE\"\n }\n }\n ],\n \"orderCompensationData\": {\n \"compensationTypeRequested\": \"REFUND\",\n \"initiationTime\": 1415287568000,\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"requestedReturnType\": \"SHIP_TO_WAREHOUSE\"\n },\n \"totalRequestedAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"connectionInformation\": {\n \"checkoutToolsSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"customerIP\": \"10.0.0.127\",\n \"forterMobileUID\": \"6429751237891\",\n \"forterTokenCookie\": \"249453te8tbf9355186fet0ken547b95_2786972955236__UDE52-n5_8dg\",\n \"merchantDeviceIdentifier\": \"HGJ7512345H3\",\n \"merchantProvidedSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"userAgent\": \"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36\"\n },\n \"eventId\": \"r48987fgdse0r\",\n \"eventTime\": 1415287568000,\n \"hasProofOfPurchase\": true,\n \"isGuestAccount\": false,\n \"merchantAgentData\": {\n \"merchantAgentId\": \"HG36885TZ\",\n \"merchantAgentName\": \"John Smith\"\n },\n \"merchantIdentifiers\": {\n \"merchantDomain\": \"HandbagsExpressDiscounts.com\",\n \"merchantName\": \"Handbags Express Discounts\"\n },\n \"originalOrderId\": \"2356fdse0rr489\",\n \"status\": {\n \"itemStatus\": [\n {\n \"basicItemData\": {\n \"category\": \"Apparel and accessories\",\n \"discount\": {\n \"couponCodeUsed\": \"FATHERSDAY2015\",\n \"couponDiscountAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"name\": \"White GenericBrand handbag\",\n \"price\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"productId\": \"Ag54352R7768kkO\",\n \"quantity\": 1,\n \"type\": \"TANGIBLE\"\n },\n \"statusData\": {\n \"compensationTypeGranted\": \"REFUND\",\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"returnCondition\": \"DAMAGED\",\n \"returnMethodGranted\": \"SHIP_TO_WAREHOUSE\",\n \"statusLog\": {\n \"arrivedToWarehouseTime\": 1420070400000,\n \"initiationTime\": 1415287568000,\n \"initiationType\": \"CALL_CENTER\",\n \"shippedByCustomerTime\": 1420070400000\n },\n \"updatedStatus\": \"ACCEPTED_BY_MERCHANT\"\n }\n }\n ],\n \"merchantAgentData\": {\n \"merchantAgentId\": \"HG36885TZ\",\n \"merchantAgentName\": \"John Smith\"\n },\n \"replacementOrderId\": \"2356fdse0rr489\",\n \"shippingRefundedAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"statusData\": {\n \"compensationTypeGranted\": \"REFUND\",\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"returnCondition\": \"DAMAGED\",\n \"returnMethodGranted\": \"SHIP_TO_WAREHOUSE\",\n \"statusLog\": {\n \"arrivedToWarehouseTime\": 1420070400000,\n \"initiationTime\": 1415287568000,\n \"initiationType\": \"CALL_CENTER\",\n \"shippedByCustomerTime\": 1420070400000\n },\n \"updatedStatus\": \"ACCEPTED_BY_MERCHANT\"\n },\n \"totalGrantedAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n }\n }'"
},
{
"id": "example-1-javascript",
"language": "javascript",
"label": "javascript",
"code": "var myHeaders = new Headers();\nmyHeaders.append(\"accept\", \"application/json\");\nmyHeaders.append(\"content-type\", \"application/json\");\nmyHeaders.append(\"api-version\", \"10.1\");\nmyHeaders.append(\"x-forter-siteid\", \"8b47c6d423ba\");\nmyHeaders.append(\"authorization\", \"Basic \");\n\nvar raw = JSON.stringify({\n \"accountId\": \"e520-ba9a-367-60b\",\n \"additionalEventIdentifiers\": {},\n \"additionalInformation\": {},\n \"compensationRequest\": {\n \"initiationType\": \"CALL_CENTER\",\n \"items\": [\n {\n \"basicItemData\": {\n \"category\": \"Apparel and accessories\",\n \"discount\": {\n \"couponCodeUsed\": \"FATHERSDAY2015\",\n \"couponDiscountAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"name\": \"White GenericBrand handbag\",\n \"price\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"productId\": \"Ag54352R7768kkO\",\n \"quantity\": 1,\n \"type\": \"TANGIBLE\"\n },\n \"itemCompensationData\": {\n \"compensationTypeRequested\": \"REFUND\",\n \"initiationTime\": 1415287568000,\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"requestedReturnType\": \"SHIP_TO_WAREHOUSE\"\n }\n }\n ],\n \"orderCompensationData\": {\n \"compensationTypeRequested\": \"REFUND\",\n \"initiationTime\": 1415287568000,\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"requestedReturnType\": \"SHIP_TO_WAREHOUSE\"\n },\n \"totalRequestedAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"connectionInformation\": {\n \"checkoutToolsSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"customerIP\": \"10.0.0.127\",\n \"forterMobileUID\": \"6429751237891\",\n \"forterTokenCookie\": \"249453te8tbf9355186fet0ken547b95_2786972955236__UDE52-n5_8dg\",\n \"merchantDeviceIdentifier\": \"HGJ7512345H3\",\n \"merchantProvidedSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"userAgent\": \"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36\"\n },\n \"eventId\": \"r48987fgdse0r\",\n \"eventTime\": 1415287568000,\n \"hasProofOfPurchase\": true,\n \"isGuestAccount\": false,\n \"merchantAgentData\": {\n \"merchantAgentId\": \"HG36885TZ\",\n \"merchantAgentName\": \"John Smith\"\n },\n \"merchantIdentifiers\": {\n \"merchantDomain\": \"HandbagsExpressDiscounts.com\",\n \"merchantName\": \"Handbags Express Discounts\"\n },\n \"originalOrderId\": \"2356fdse0rr489\",\n \"status\": {\n \"itemStatus\": [\n {\n \"basicItemData\": {\n \"category\": \"Apparel and accessories\",\n \"discount\": {\n \"couponCodeUsed\": \"FATHERSDAY2015\",\n \"couponDiscountAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"name\": \"White GenericBrand handbag\",\n \"price\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"productId\": \"Ag54352R7768kkO\",\n \"quantity\": 1,\n \"type\": \"TANGIBLE\"\n },\n \"statusData\": {\n \"compensationTypeGranted\": \"REFUND\",\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"returnCondition\": \"DAMAGED\",\n \"returnMethodGranted\": \"SHIP_TO_WAREHOUSE\",\n \"statusLog\": {\n \"arrivedToWarehouseTime\": 1420070400000,\n \"initiationTime\": 1415287568000,\n \"initiationType\": \"CALL_CENTER\",\n \"shippedByCustomerTime\": 1420070400000\n },\n \"updatedStatus\": \"ACCEPTED_BY_MERCHANT\"\n }\n }\n ],\n \"merchantAgentData\": {\n \"merchantAgentId\": \"HG36885TZ\",\n \"merchantAgentName\": \"John Smith\"\n },\n \"replacementOrderId\": \"2356fdse0rr489\",\n \"shippingRefundedAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"statusData\": {\n \"compensationTypeGranted\": \"REFUND\",\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"returnCondition\": \"DAMAGED\",\n \"returnMethodGranted\": \"SHIP_TO_WAREHOUSE\",\n \"statusLog\": {\n \"arrivedToWarehouseTime\": 1420070400000,\n \"initiationTime\": 1415287568000,\n \"initiationType\": \"CALL_CENTER\",\n \"shippedByCustomerTime\": 1420070400000\n },\n \"updatedStatus\": \"ACCEPTED_BY_MERCHANT\"\n },\n \"totalGrantedAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n }\n});\n\nvar requestOptions = {\n method: 'POST',\n headers: myHeaders,\n body: raw,\n redirect: 'follow'\n};\n\nfetch(\"https://api.forter-secure.com/v2/unified-compensation-request/{id}\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));"
},
{
"id": "example-2-ruby",
"language": "ruby",
"label": "Ruby",
"code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.forter-secure.com/v2/unified-compensation-request/{id}\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Post.new(url)\nrequest[\"accept\"] = \"application/json\"\nrequest[\"content-type\"] = \"application/json\"\nrequest[\"api-version\"] = \"10.1\"\nrequest[\"x-forter-siteid\"] = \"8b47c6d423ba\"\nrequest[\"authorization\"] = \"Basic \"\nrequest.body = JSON.dump({\n \"accountId\": \"e520-ba9a-367-60b\",\n \"additionalEventIdentifiers\": {},\n \"additionalInformation\": {},\n \"compensationRequest\": {\n \"initiationType\": \"CALL_CENTER\",\n \"items\": [\n {\n \"basicItemData\": {\n \"category\": \"Apparel and accessories\",\n \"discount\": {\n \"couponCodeUsed\": \"FATHERSDAY2015\",\n \"couponDiscountAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"name\": \"White GenericBrand handbag\",\n \"price\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"productId\": \"Ag54352R7768kkO\",\n \"quantity\": 1,\n \"type\": \"TANGIBLE\"\n },\n \"itemCompensationData\": {\n \"compensationTypeRequested\": \"REFUND\",\n \"initiationTime\": 1415287568000,\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"requestedReturnType\": \"SHIP_TO_WAREHOUSE\"\n }\n }\n ],\n \"orderCompensationData\": {\n \"compensationTypeRequested\": \"REFUND\",\n \"initiationTime\": 1415287568000,\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"requestedReturnType\": \"SHIP_TO_WAREHOUSE\"\n },\n \"totalRequestedAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"connectionInformation\": {\n \"checkoutToolsSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"customerIP\": \"10.0.0.127\",\n \"forterMobileUID\": \"6429751237891\",\n \"forterTokenCookie\": \"249453te8tbf9355186fet0ken547b95_2786972955236__UDE52-n5_8dg\",\n \"merchantDeviceIdentifier\": \"HGJ7512345H3\",\n \"merchantProvidedSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"userAgent\": \"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36\"\n },\n \"eventId\": \"r48987fgdse0r\",\n \"eventTime\": 1415287568000,\n \"hasProofOfPurchase\": true,\n \"isGuestAccount\": false,\n \"merchantAgentData\": {\n \"merchantAgentId\": \"HG36885TZ\",\n \"merchantAgentName\": \"John Smith\"\n },\n \"merchantIdentifiers\": {\n \"merchantDomain\": \"HandbagsExpressDiscounts.com\",\n \"merchantName\": \"Handbags Express Discounts\"\n },\n \"originalOrderId\": \"2356fdse0rr489\",\n \"status\": {\n \"itemStatus\": [\n {\n \"basicItemData\": {\n \"category\": \"Apparel and accessories\",\n \"discount\": {\n \"couponCodeUsed\": \"FATHERSDAY2015\",\n \"couponDiscountAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"name\": \"White GenericBrand handbag\",\n \"price\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"productId\": \"Ag54352R7768kkO\",\n \"quantity\": 1,\n \"type\": \"TANGIBLE\"\n },\n \"statusData\": {\n \"compensationTypeGranted\": \"REFUND\",\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"returnCondition\": \"DAMAGED\",\n \"returnMethodGranted\": \"SHIP_TO_WAREHOUSE\",\n \"statusLog\": {\n \"arrivedToWarehouseTime\": 1420070400000,\n \"initiationTime\": 1415287568000,\n \"initiationType\": \"CALL_CENTER\",\n \"shippedByCustomerTime\": 1420070400000\n },\n \"updatedStatus\": \"ACCEPTED_BY_MERCHANT\"\n }\n }\n ],\n \"merchantAgentData\": {\n \"merchantAgentId\": \"HG36885TZ\",\n \"merchantAgentName\": \"John Smith\"\n },\n \"replacementOrderId\": \"2356fdse0rr489\",\n \"shippingRefundedAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"statusData\": {\n \"compensationTypeGranted\": \"REFUND\",\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"returnCondition\": \"DAMAGED\",\n \"returnMethodGranted\": \"SHIP_TO_WAREHOUSE\",\n \"statusLog\": {\n \"arrivedToWarehouseTime\": 1420070400000,\n \"initiationTime\": 1415287568000,\n \"initiationType\": \"CALL_CENTER\",\n \"shippedByCustomerTime\": 1420070400000\n },\n \"updatedStatus\": \"ACCEPTED_BY_MERCHANT\"\n },\n \"totalGrantedAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n }\n})\n\nresponse = https.request(request)\nputs response.read_body\n"
},
{
"id": "example-3-python",
"language": "python",
"label": "Python",
"code": "import requests\nimport json\n\nurl = \"https://api.forter-secure.com/v2/unified-compensation-request/{id}\"\n\npayload = json.dumps({\n \"accountId\": \"e520-ba9a-367-60b\",\n \"additionalEventIdentifiers\": {},\n \"additionalInformation\": {},\n \"compensationRequest\": {\n \"initiationType\": \"CALL_CENTER\",\n \"items\": [\n {\n \"basicItemData\": {\n \"category\": \"Apparel and accessories\",\n \"discount\": {\n \"couponCodeUsed\": \"FATHERSDAY2015\",\n \"couponDiscountAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"name\": \"White GenericBrand handbag\",\n \"price\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"productId\": \"Ag54352R7768kkO\",\n \"quantity\": 1,\n \"type\": \"TANGIBLE\"\n },\n \"itemCompensationData\": {\n \"compensationTypeRequested\": \"REFUND\",\n \"initiationTime\": 1415287568000,\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"requestedReturnType\": \"SHIP_TO_WAREHOUSE\"\n }\n }\n ],\n \"orderCompensationData\": {\n \"compensationTypeRequested\": \"REFUND\",\n \"initiationTime\": 1415287568000,\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"requestedReturnType\": \"SHIP_TO_WAREHOUSE\"\n },\n \"totalRequestedAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"connectionInformation\": {\n \"checkoutToolsSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"customerIP\": \"10.0.0.127\",\n \"forterMobileUID\": \"6429751237891\",\n \"forterTokenCookie\": \"249453te8tbf9355186fet0ken547b95_2786972955236__UDE52-n5_8dg\",\n \"merchantDeviceIdentifier\": \"HGJ7512345H3\",\n \"merchantProvidedSessionId\": \"HTGDVC232fdFDFdfkdjk87382938mcndjc2f4gbbGd\",\n \"userAgent\": \"Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/47.0.2526.73 Safari/537.36\"\n },\n \"eventId\": \"r48987fgdse0r\",\n \"eventTime\": 1415287568000,\n \"hasProofOfPurchase\": True,\n \"isGuestAccount\": False,\n \"merchantAgentData\": {\n \"merchantAgentId\": \"HG36885TZ\",\n \"merchantAgentName\": \"John Smith\"\n },\n \"merchantIdentifiers\": {\n \"merchantDomain\": \"HandbagsExpressDiscounts.com\",\n \"merchantName\": \"Handbags Express Discounts\"\n },\n \"originalOrderId\": \"2356fdse0rr489\",\n \"status\": {\n \"itemStatus\": [\n {\n \"basicItemData\": {\n \"category\": \"Apparel and accessories\",\n \"discount\": {\n \"couponCodeUsed\": \"FATHERSDAY2015\",\n \"couponDiscountAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n },\n \"name\": \"White GenericBrand handbag\",\n \"price\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"productId\": \"Ag54352R7768kkO\",\n \"quantity\": 1,\n \"type\": \"TANGIBLE\"\n },\n \"statusData\": {\n \"compensationTypeGranted\": \"REFUND\",\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"returnCondition\": \"DAMAGED\",\n \"returnMethodGranted\": \"SHIP_TO_WAREHOUSE\",\n \"statusLog\": {\n \"arrivedToWarehouseTime\": 1420070400000,\n \"initiationTime\": 1415287568000,\n \"initiationType\": \"CALL_CENTER\",\n \"shippedByCustomerTime\": 1420070400000\n },\n \"updatedStatus\": \"ACCEPTED_BY_MERCHANT\"\n }\n }\n ],\n \"merchantAgentData\": {\n \"merchantAgentId\": \"HG36885TZ\",\n \"merchantAgentName\": \"John Smith\"\n },\n \"replacementOrderId\": \"2356fdse0rr489\",\n \"shippingRefundedAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n },\n \"statusData\": {\n \"compensationTypeGranted\": \"REFUND\",\n \"internalReasonCategory\": \"defective item\",\n \"reasonCategory\": \"CHANGED_MY_MIND\",\n \"returnCondition\": \"DAMAGED\",\n \"returnMethodGranted\": \"SHIP_TO_WAREHOUSE\",\n \"statusLog\": {\n \"arrivedToWarehouseTime\": 1420070400000,\n \"initiationTime\": 1415287568000,\n \"initiationType\": \"CALL_CENTER\",\n \"shippedByCustomerTime\": 1420070400000\n },\n \"updatedStatus\": \"ACCEPTED_BY_MERCHANT\"\n },\n \"totalGrantedAmount\": {\n \"amountLocalCurrency\": \"105.55\",\n \"amountUSD\": \"99.95\",\n \"currency\": \"CAD\"\n }\n }\n})\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json',\n 'api-version': '10.1',\n 'x-forter-siteid': '8b47c6d423ba',\n 'authorization': 'Basic '\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n"
}
],
"selectedLanguageId": "example-0-curl"
},
"results": {
"languages": [
{
"id": "response-0-200",
"language": "200",
"code": "// Example unifiedCompensationRequestResponse\n{\n \"correlationId\": \"\",\n \"decisionReason\": \"\",\n \"forterDecision\": \"\",\n \"merchantPolicyId\": \"\",\n \"recommendations\": [\n \"\"\n ],\n \"status\": \"\"\n}"
},
{
"id": "response-1-400",
"language": "400",
"code": "// Bad Request (Often missing a required parameter)\n"
},
{
"id": "response-2-401",
"language": "401",
"code": "// Unauthorized (No valid API key provided)\n"
},
{
"id": "response-3-404",
"language": "404",
"code": "// Not Found (The requested item doesn't exist)\n"
},
{
"id": "response-4-500",
"language": "500",
"code": "// Server Error (Something went wrong on Forter's end)\n"
}
],
"selectedLanguageId": "response-0-200"
}
},
"children": [
{
"id": "6gV1OCdhcJkixGpRVyQRC",
"type": "paragraph",
"children": [
{
"text": "顧客が開始した補償要求（返金や再発送など）に関する情報を送信し、詐欺または悪用に関する決定を受け取ります。\n要求は注文レベルまたはアイテムレベルで行うことができます。返答には、あなたの悪用防止ポリシーに基づく推奨事項も含まれる場合があります。"
}
]
}
]
}