Dispute Notifications

notifying forter of chargebacks and fraud alerts is extremely important because it enables forter’s system to learn and continually improve future decisions, tailoring our system to your company’s needs it is also required for chargeback recovery and coverage services to make sure forter knows which chargebacks have been submitted and should be reimbursed or appealed include processor specific ids in your order api request when your psp sends the dispute information to forter, they will generally include a unique id specific to their system and may not include the same order id that was provided in the initial call to forter's order api be sure that your order api request includes this processor specific id in the paymentprocessordata object this will allow forter to connect the dispute to the existing order in our system choosing the correct dispute notification method forter supports four different ways to send us your chargebacks from your psp the most efficient way to do this is by setting up dispute webhooks between your psp and forter setup a webhook per psp forter can support and accept dispute webhook notifications from adyen # , braintree # , checkout com hub # , checkout com nas # , paypal # primer # , and stripe # for each of your psps, follow the instructions to set up a dispute webhook webhook configurations are mandatory for processors that offer webhook capabilities once implemented, save the webhook credentials to a txt file with the file naming convention "jcbr yoursitename processorname" (e g "jcbr tshirtsexpress primer") and upload it securely to your s3 folder please notify your forter implementation engineer once you have uploaded these files send notifications via sftp if any of your psps are not supported through webhooks, and your processor (including but not limited to amex, chase, or evalon) supports granting forter the necessary permissions, we can automatically retrieve your new chargeback sftp files when they become available don't hesitate to contact your psp's representative to check whether they support sftp chargeback files send notification via dispute api if any of your psps are not supported through webhooks, use the dispute api https //docs forter com/reference/dispute to send each notification, with the following information data point parameter notes order id orderid include the orderid value you sent with the initial order processor name processorname include the processorname value you sent with payment authorization processor transaction id chargeid include the processortransactionid value you sent with payment authorization case id processorchargebackcaseid dispute type type dispute status status amount amount reason reasontype and reasoncode issue date issuedate due date duedate source sourcetype and sourcedetails dispute api request example { "orderid" "4306795", "processorchargebackcaseid" "cb 4343343219", "status" "open", "externalclaimstatus" "pending merchant response", "amount" { "amountusd" "99 95", "amountlocalcurrency" "105 55", "currency" "cad" }, "additionalcost" { "amountusd" "99 95", "amountlocalcurrency" "105 55", "currency" "cad" }, "type" "chargeback", "sourcetype" "processor cb", "sourcedetails" "ups", "reasontype" "fraud", "reason" "fraudulent transaction card not present environment", "reasoncode" "83", "issuedate" "2016 01 20", "duedate" "2016 01 30", "goodsrecovered" false, "wasrefunded" false, "invoiceurl" "mystore com/invoices/abc123", "comments" "contacted customer via phone" } ' dispute api response the response details whether or not the dispute was received successfully chargebacks will also show on the original transaction in the forter portal and can be included in relevant claims reporting in the portal as we s3 csv file upload if webhooks, sftp, or dispute api are not feasible solutions, then we can explore setting up csv uploads to forter on a frequent cadence