Fraud Management
Post-purchase Updates
8 min
ensure that forter’s system has the most up to date information about the status of individual orders, including payment authorization (for pre auth flows), fulfillment status, and returns or compensation this helps forter protect your company by ensuring that changes in an order status don’t expose your company to fraud for example, if a customer calls up your customer support and asks to change the address to which they’re sending their delivery then that might be a suspicious sign, depending on the address used by sending forter order status updates, your company can make sure forter has the ongoing information we need to protect you our goal is to understand if the order was authorized by the bank, completed/delivered, or rejected/canceled at a later phase order status updates when forter receives updates after the checkout decision is made, we use the orderid provided in the order api as the identifier to connect to the original order and ensure orders are tracked seamlessly you can send order status updates for up to 18 months after checkout payment authorization update for pre authorization flows, you can streamline the process of sending payment authorization updates by creating a webhook notification from your payment processors that they will send directly to forter forter can accept payment webhook notifications from adyen https //docs forter com/adyen dispute webhook , primer payment webhook docid\ yeccn0qjuspg1st iyto3 , and worldpay payment webhook docid\ kjb97osjbrdobsu1u0llx for all other payment processors, send an update via the order status api with mapped values from the payment authentication information you received data point parameter in payment \[paymentmethod] object notes authorization code verificationresults authorizationcode or processorresponsecode or processorresponsetext avs result verificationresults avsfullresult or avsstreetresult and avszipresult in countries where address is verified cvv result verificationresults cvvresult 3ds status verificationresults threedsstatus or ecivalue or cavvvalue payment processor paymentprocessordata processorname processor transaction id paymentprocessordata processortransactionid for proper mapping, include this value as chargeid when reporting disputes also include an updated status for the order with this request when the authorization succeeds, updatedstatus “processing” when the authorization fails, updatedstatus “canceled by merchant” order status api request example for payment authorization { "orderid" "1415287568000", "eventtime" 1661893713000, "updatedstatus" "processing", "updatedmerchantstatus" "card auth tokenised", "verificationresults" { "cvvresult" "m", "avsstreetresult" "m", "processorresponsecode" "1000", "processorresponsetext" "approved", "cavvresult" "vybonwcsb3f9gtisbaujveulw0o=", "ecivalue" "05", "threedsstatus" "cardholder authenticated", "liabilityshift" true, "threedsversion" "2 1 0", "authorizationprocessedwith3ds" true } } order fulfillment update when there is an update to the order status whether sent, completed, returned, canceled, etc call the order status api using forter's enumerated status types this will not return a decision, but provides valuable information to inform our decision models data point parameter notes new order status updatedstatus see enum definitions below status change datetime eventtime the definitions of an order's status are processing when the order is placed successfully, but you have not yet sent any items to the customer sent when you have sent part of the order to the recipient completed when you have sent the entire order to the recipient canceled by merchant or canceled by customer when an order is canceled in entirety if only some items in the order are canceled prior to fulfillment, send the updatedtotalamount and adjusted cartitems , but retain the processing or sent status for the order order status api request example for fulfillment update { "additionalinformation" {}, "deliverystatusinfo" { "additionalshippinginfo" "po box 3297", "customeropenedemail" false, "proofofshippingurl" true, "signedproofofshipping" true }, "eventid" "r48987fgdse0r", "eventtime" 1415287568000, "orderid" "2356fdse0rr489", "statuschangereason" "fraud team manual decline", "updatedmerchantstatus" "shipped", "updatedstatus" "sent", "updatedtotalamount" { "amountlocalcurrency" 105 55, "amountusd" 99 95, "currency" "cad" } } compensation update when a customer is granted compensation or an appeasement (e g refund, replacement, return, store credit, etc), include the compensationstatus object in the order status api along with the eventtime and updatedstatus of the order this will not return a decision, but provides valuable information to inform our decision models if the compensation request applies to only some items in the order, include the statusdata object at the item level within the itemstatus array data point parameter in compensationstatus object notes items itemstatus basicitemdata include name, price, quantity and type type statusdata compensationtypegranted reason provided statusdata reasoncategory return method statusdata returnmethodgranted request status statusdata updatedstatus amount totalgrantedamount order status api response the response details whether or not the order status update was completed successfully it will not return a new decision example { "message" "transaction #\ id status recieved", "status" "success" }