Post-purchase Updates

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 important for tracking 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 status change datetime eventtime 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 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 if the compensation request applies to only some items in the order, include the statusdata object at the item level within the itemstatus array 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" }