Core API
Orders
Order update
1 min
code examples curl location globoff 'https //api forter secure com/v2/order update/{id}' \\ \ header 'accept application/json' \\ \ header 'content type application/json' \\ \ data '{ "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" }, "merchantfeedback" { "merchantcustomersupport" { "contactemailused" {}, "contactmethodtype" "phone", "contactnameused" { "customercontactnametype" "other" }, "contactphoneused" {}, "contacttime" 1430997968, "customersupportchangeorderdetails" {}, "customersupportfurtherverification" { "customeransweredsecurityquestions" true, "customersupportadditionalverificationdocuments" { "documenttype" "passport" } }, "initiatedby" "customer" }, "merchantwouldlikeapproved" { "merchantcontactedissuer" {}, "merchantdisagreeswithspecificdeclinereason" { "atoisirrelevant" {}, "chbkisirrelevant" {} }, "merchantfoundbuyerexposure" { "customersignedinusinglegitsocialnetworkaccount" {}, "merchantfoundbuyeremailonline" {}, "merchantfoundbuyerphonenumberonline" {}, "merchantfoundconnectionbetweenindividualsintheorder" { "datasource" {} }, "merchantfoundconnectionbetweennameandaddress" { "datasource" {} }, "merchantfoundrecipientemailonline" {}, "merchantfoundrecipientphonenumberonline" {} }, "merchantpolicydecisionnotapplicable" {}, "merchantthinksordercharacteristicsarelegit" { "goodcustomer" { "establishedaccount" { "establishedaccountdetails" {}, "relatedaccountdetails" {} }, "previouspointofsalepurchase" {} }, "lowriskpaymentmethod" {} } }, "merchantwouldlikedeclined" { "fraudtypesuspectedbymerchant" { "merchantsuspectsaccounttakeover" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsbuyersellercollusion" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsfraudother" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsfriendlyfraud" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsstolenpaymentmethod" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} } } } }, "orderid" "2356fdse0rr489", "primaryrecipient" { "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 } } ] }, "totalamount" {} }'var myheaders = new headers(); myheaders append("accept", "application/json"); myheaders append("content type", "application/json"); var raw = json stringify({ "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" }, "merchantfeedback" { "merchantcustomersupport" { "contactemailused" {}, "contactmethodtype" "phone", "contactnameused" { "customercontactnametype" "other" }, "contactphoneused" {}, "contacttime" 1430997968, "customersupportchangeorderdetails" {}, "customersupportfurtherverification" { "customeransweredsecurityquestions" true, "customersupportadditionalverificationdocuments" { "documenttype" "passport" } }, "initiatedby" "customer" }, "merchantwouldlikeapproved" { "merchantcontactedissuer" {}, "merchantdisagreeswithspecificdeclinereason" { "atoisirrelevant" {}, "chbkisirrelevant" {} }, "merchantfoundbuyerexposure" { "customersignedinusinglegitsocialnetworkaccount" {}, "merchantfoundbuyeremailonline" {}, "merchantfoundbuyerphonenumberonline" {}, "merchantfoundconnectionbetweenindividualsintheorder" { "datasource" {} }, "merchantfoundconnectionbetweennameandaddress" { "datasource" {} }, "merchantfoundrecipientemailonline" {}, "merchantfoundrecipientphonenumberonline" {} }, "merchantpolicydecisionnotapplicable" {}, "merchantthinksordercharacteristicsarelegit" { "goodcustomer" { "establishedaccount" { "establishedaccountdetails" {}, "relatedaccountdetails" {} }, "previouspointofsalepurchase" {} }, "lowriskpaymentmethod" {} } }, "merchantwouldlikedeclined" { "fraudtypesuspectedbymerchant" { "merchantsuspectsaccounttakeover" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsbuyersellercollusion" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsfraudother" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsfriendlyfraud" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsstolenpaymentmethod" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} } } } }, "orderid" "2356fdse0rr489", "primaryrecipient" { "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 } } ] }, "totalamount" {} }); var requestoptions = { method 'post', headers myheaders, body raw, redirect 'follow' }; fetch("https //api forter secure com/v2/order update/{id}", requestoptions) then(response => response text()) then(result => console log(result)) catch(error => console log('error', error));require "uri" require "json" require "net/http" url = uri("https //api forter secure com/v2/order update/{id}") https = net http new(url host, url port) https use ssl = true request = net http post new(url) request\["accept"] = "application/json" request\["content type"] = "application/json" request body = json dump({ "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" }, "merchantfeedback" { "merchantcustomersupport" { "contactemailused" {}, "contactmethodtype" "phone", "contactnameused" { "customercontactnametype" "other" }, "contactphoneused" {}, "contacttime" 1430997968, "customersupportchangeorderdetails" {}, "customersupportfurtherverification" { "customeransweredsecurityquestions" true, "customersupportadditionalverificationdocuments" { "documenttype" "passport" } }, "initiatedby" "customer" }, "merchantwouldlikeapproved" { "merchantcontactedissuer" {}, "merchantdisagreeswithspecificdeclinereason" { "atoisirrelevant" {}, "chbkisirrelevant" {} }, "merchantfoundbuyerexposure" { "customersignedinusinglegitsocialnetworkaccount" {}, "merchantfoundbuyeremailonline" {}, "merchantfoundbuyerphonenumberonline" {}, "merchantfoundconnectionbetweenindividualsintheorder" { "datasource" {} }, "merchantfoundconnectionbetweennameandaddress" { "datasource" {} }, "merchantfoundrecipientemailonline" {}, "merchantfoundrecipientphonenumberonline" {} }, "merchantpolicydecisionnotapplicable" {}, "merchantthinksordercharacteristicsarelegit" { "goodcustomer" { "establishedaccount" { "establishedaccountdetails" {}, "relatedaccountdetails" {} }, "previouspointofsalepurchase" {} }, "lowriskpaymentmethod" {} } }, "merchantwouldlikedeclined" { "fraudtypesuspectedbymerchant" { "merchantsuspectsaccounttakeover" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsbuyersellercollusion" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsfraudother" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsfriendlyfraud" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsstolenpaymentmethod" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} } } } }, "orderid" "2356fdse0rr489", "primaryrecipient" { "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 } } ] }, "totalamount" {} }) response = https request(request) puts response read body import requests import json url = "https //api forter secure com/v2/order update/{id}" payload = json dumps({ "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" }, "merchantfeedback" { "merchantcustomersupport" { "contactemailused" {}, "contactmethodtype" "phone", "contactnameused" { "customercontactnametype" "other" }, "contactphoneused" {}, "contacttime" 1430997968, "customersupportchangeorderdetails" {}, "customersupportfurtherverification" { "customeransweredsecurityquestions" true, "customersupportadditionalverificationdocuments" { "documenttype" "passport" } }, "initiatedby" "customer" }, "merchantwouldlikeapproved" { "merchantcontactedissuer" {}, "merchantdisagreeswithspecificdeclinereason" { "atoisirrelevant" {}, "chbkisirrelevant" {} }, "merchantfoundbuyerexposure" { "customersignedinusinglegitsocialnetworkaccount" {}, "merchantfoundbuyeremailonline" {}, "merchantfoundbuyerphonenumberonline" {}, "merchantfoundconnectionbetweenindividualsintheorder" { "datasource" {} }, "merchantfoundconnectionbetweennameandaddress" { "datasource" {} }, "merchantfoundrecipientemailonline" {}, "merchantfoundrecipientphonenumberonline" {} }, "merchantpolicydecisionnotapplicable" {}, "merchantthinksordercharacteristicsarelegit" { "goodcustomer" { "establishedaccount" { "establishedaccountdetails" {}, "relatedaccountdetails" {} }, "previouspointofsalepurchase" {} }, "lowriskpaymentmethod" {} } }, "merchantwouldlikedeclined" { "fraudtypesuspectedbymerchant" { "merchantsuspectsaccounttakeover" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsbuyersellercollusion" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsfraudother" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsfriendlyfraud" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} }, "merchantsuspectsstolenpaymentmethod" { "merchantsuspectsaccountdetails" {}, "merchantsuspectsorderdetails" {} } } } }, "orderid" "2356fdse0rr489", "primaryrecipient" { "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 } } ] }, "totalamount" {} }) headers = { 'accept' 'application/json', 'content type' 'application/json' } response = requests request("post", url, headers=headers, data=payload) print(response text) responses // example validationresponse { "action" "approve", "message" "", "reasoncode" "", "recommendations" \[ "" ], "status" "success", "transaction" "123456" }// bad request (often missing a required parameter) // unauthorized (no valid api key provided) // not found (the requested item doesn't exist) // server error (something went wrong on forter's end)