--- title: 3DS result slug: reference/3ds-result docTags: createdAt: 2026-08-23T06:01:06.452Z --- { "id": "ZRwXyIOanDLLIPJp1IgRq", "type": "api-oas-v2", "data": { "method": "POST", "url": "https://api.forter-secure.com/v3/orders/{id}/results", "servers": [ { "url": "https://api.forter-secure.com/v3/orders/{id}/results" } ], "name": "3DS result", "description": "Check the 3DS results using the managed order token returned in Forter's response to the order request.", "contentType": "application/json", "request": { "pathParameters": [ { "kind": "required", "name": "id", "type": "string", "description": "" } ], "headerParameters": [ { "name": "accept", "type": "string", "kind": "optional", "description": "Generated from available response content types", "enum": [ "application/json" ], "default": "application/json" }, { "kind": "required", "name": "api-version", "type": "string", "example": "10.3", "description": "Specify the version of the API to target." }, { "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.

" } ], "queryParameters": [], "bodyDataParameters": [ { "kind": "required", "name": "body", "type": "object", "description": "Check the 3DS results using the managed order token returned in Forter's response to the order request.", "customType": "v3OrderResultsRequest", "schema": [ { "name": "managedOrderToken", "kind": "required", "type": "string", "description": "The managedOrderToken returned from the create endpoint", "example": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IjIwMjMtMDUtMjMifQ.eyJmb3J0ZXJPcGFxdWVEYXRhIjoiZm9ydGVyT3BhcXVlRGF0YSIsImF1ZCI6ImNoZWNrb3V0dG9vbHMiLCJpc3MiOiJodHRwczovL2FwaS5jaGVja291dHRvb2xzLmNvbS92My9tYW5hZ2VkL29yZGVycyIsImV4cCI6MTczMzk0NzYxNH0.i3Q2KsUerRNQMfCGKQgoR_0AIENOKZ0C99kiRtlkuVQqbmhPRo0A4c42XHp0J_-kdJbCW2W1WckgglTy8GGRfwzVfZ2szSxJCB6QOd4uHwn0BN1GeTdY3qjtBHF48ihsDhfYXvII4Kl2zpL54aJfCePuYANedhxAWJZnUCcSKxFDYsj-gHGGApZbgPhnMI1QfUme2CHjpxu2vGTC0xC08OQuYO7vbESQU_YnLsc-xQYBrOy_4XuOEJDq8fK2O5saiZZEknNvLxouAzn16p5lzWJ3sp-tsJR-a9C_KgNqz_Nv4SaeSYQMhJwrYXXLhNP2ueTHdzEObtm7Skp_NQFdXBBF4vMO4HhKKBzNnfWjsKKCb6Utb__AZNbW4XYn9788wdHNVu-TVhiHRYOg19iOHaJS1l8DfHqMN0o-98Cmdu9prhGIvey64FrcEoAf9jhUjT4LN9u0zuH1jbwfpG-owmHEnpAY6dtZilK81zrf6A3OhRIB5_cECdutSa_UHXP1xapUsGoQMy3T5qaecnj6VqwXI1Cc3vrhsaewRCqJqDTeHG2slttrWBrigvXk4rFwWVazn_Y_PCy-WCfcazXK6nTCJTQ_mBoM24S-W6jRlOsfplDDl5cKGrvsulqXDuDqRzJnc_AmkVOWM9AvqqgkC5ef_2xcGprFi4xDjXkScz4", "maxLength": 65536 } ], "modelRef": "#/components/schemas/v3OrderResultsRequest", "isExpanded": true } ], "formDataParameters": [], "oAuthParameters": [ { "id": "basicAuth", "name": "basicAuth", "kind": "optional", "type": "http", "scheme": "basic" } ], "cookieParameters": [] }, "responses": [ { "statusCode": "200", "description": "Example v3OrderResultsResponse", "jsonExample": "", "isExpanded": true, "schema": [ { "kind": "optional", "type": "object", "description": "", "customType": "v3OrderResultsResponse", "schema": [ { "name": "correlationId", "kind": "required", "type": "string", "description": "

A unique identifier for the request, used to correlate the Forter decision with subsequent API calls

", "example": "a1b2c3d4e5f6" }, { "name": "decisionReason", "kind": "required", "type": "string", "description": "The main reason behind the Forter decision", "example": "", "maxLength": 1000 }, { "name": "forterDecision", "kind": "required", "type": "string", "description": "The latest Forter decision regarding the attempted action", "example": "APPROVE", "enum": [ "APPROVE", "DECLINE", "NOT REVIEWED" ] }, { "name": "linkToEventInDashboard", "kind": "required", "type": "string", "description": "Link to the event in the decision dashboard", "example": "https://portal.forter.com/dashboard/:id", "maxLength": 1000 }, { "name": "merchantPolicyId", "kind": "required", "type": "string", "description": "UID of the custom policy created in Forter's Policies tool that resulted in this decision", "example": "0ee8ba28a8654c659addbae9253b707c" }, { "name": "orderId", "kind": "required", "type": "string", "description": "

Transaction/order ID. Note that Forter treats this ID as case-insensitive; Order123 and ORDER123 will be identified as the same order.

", "example": "123456" }, { "name": "recommendation", "kind": "required", "type": "string", "description": "

A specific recommendation for an action that might help the customer to complete their transaction/action (e.g. verify phone via SMS, verify via push notification, verify email, perform a 3DS check, etc.)

", "example": "", "maxLength": 1000 }, { "name": "verificationMethod", "kind": "required", "type": "object", "description": "The specific verification method to be used when verification is required according to \"recommendation\" field", "modelRef": "#/components/schemas/VerificationMethod", "customType": "VerificationMethod", "schema": [ { "name": "correlationId", "kind": "required", "type": "string", "description": "A forter unique identifier that was provided as part of a Forter API response recommending additional authentication measures. Used to correlate between the user action which triggered the recommendation and the authentication attempt result. Required when the additional authentication was triggered by Forter's recommendation.", "example": "HGJ7512345H3DE" }, { "name": "status", "kind": "required", "type": "string", "description": "Verification status", "example": "FRICTIONLESS", "maxLength": 50 }, { "name": "statusCode", "kind": "required", "type": "string", "description": "Verification status code", "example": "100", "maxLength": 50 }, { "name": "statusMessage", "kind": "required", "type": "string", "description": "Text describes the verification status", "example": "Verification code sent", "maxLength": 50 }, { "name": "type", "kind": "required", "type": "string", "description": "Verification method type", "example": "THREE_DS", "enum": [ "OTP_SMS", "OTP_EMAIL", "THREE_DS" ], "maxLength": 50 }, { "name": "verificationId", "kind": "required", "type": "string", "description": "A unique identifier assigned to that specific verification", "example": "345H3DEHGJ7512" }, { "name": "verificationSpecificData", "kind": "required", "type": "object", "description": "Data specific to the verification type performed", "modelRef": "#/components/schemas/VerificationData", "customType": "VerificationData", "schema": [ { "name": "ThreeDS", "kind": "optional", "type": "object", "description": "", "complexType": "allOf", "complexItems": [ { "name": "ThreeDSecureResponse", "description": "", "modelRef": "#/components/schemas/ThreeDSecureResponse", "schema": [ { "name": "ACSUrl", "kind": "required", "type": "string", "description": "

In case of challange, this url is needed to be passed to client side and trigger ftr__.init3DS function

", "example": "https:/ /acs-us-east-1.nd.nds-sandbox-issuer.com/api/v1/acs/browser_sdk_challenges", "maxLength": 2048 }, { "name": "ECIValue", "kind": "required", "type": "string", "description": "

Electronic Commerce Indicator (ECI) is a value that is returned from the Directory Server (Visa, MasterCard, etc) to indicate the authentication results of your customer's credit card payment on 3D Secure. ECI only available when the challenge is not needed or after challenge had been completed. Possible values: 00, 01, 02, 04, 05, 06, 07

", "example": "02", "maxLength": 300 }, { "name": "acsChallengeMandated", "kind": "required", "type": "string", "description": "

Indication of whether a challenge is required for the transaction to be authorised due to local/regional mandates or other variable (Y - Challenge is mandated, N - Challenge is not mandated)

", "example": "Y", "maxLength": 1 }, { "name": "acsReferenceNumber", "kind": "required", "type": "string", "description": "

Unique identifier assigned by the EMVCo Secretariat = required for mobile app implementation

", "example": "ftr-internal-acs-approval", "maxLength": 32 }, { "name": "acsSignedContent", "kind": "required", "type": "string", "description": "ACS Signed Content required for mobile app implementation", "example": "", "maxLength": 1000 }, { "name": "acsTransID", "kind": "required", "type": "string", "description": "

Universally Unique transaction identifier assigned by the ACS to identify a single transaction - required for mobile app implementation

", "example": "6fd30e89-8171-4cc3-b86e-3d59582af2f6", "maxLength": 36 }, { "name": "authenticationType", "kind": "required", "type": "string", "description": "

Optional authentication type (01 - Static, 02 - Dynamic, 03 - OOB, 04 - Decoupled)

", "example": "01", "maxLength": 2 }, { "name": "authenticationValue", "kind": "required", "type": "string", "description": "

3DS Authentication value (AV) should be sent to the payment gateway in the authorization call

", "example": "tSvPDt3PINNaoL+ERXdg0jVrmWc=", "maxLength": 28 }, { "name": "bankLiabilityShift", "kind": "required", "type": "boolean", "description": "Indicates whether transaction is supposed to get liability shift from issuer", "example": true, "maxLength": 1 }, { "name": "cardEnrolled", "kind": "required", "type": "string", "description": "

3DS transaction card Enrolled status - should be sent to the payment gateway in the authorization call in some payment gateways

", "example": "Y", "maxLength": 1 }, { "name": "cavvAlgorithm", "kind": "required", "type": "string", "description": "

3DS Authentication value algorithm - should be sent to the payment gateway in the authorization call in some payment gateways. Possible values (3DS1 only): 0, 1, 2, 3, 4, 7

", "example": "3", "maxLength": 1 }, { "name": "challengeCancel", "kind": "required", "type": "string", "description": "

Indicator informing the ACS and the DS that the authentication has been canceled. Possible values: 01-99

", "example": "01", "maxLength": 2 }, { "name": "challengeStatus", "kind": "required", "type": "string", "description": "

Ares transStatus value (Possible values: U, N, Y, A, C, D, R, I)

", "example": "Y", "maxLength": 1 }, { "name": "dsTransID", "kind": "required", "type": "string", "description": "Universally unique transaction identifier assigned by the DS to identify a single transaction", "example": "38bbf46f-c023-4f4c-ae2c-35fb301632a5", "maxLength": 100 }, { "name": "encodedChallengeRequest", "kind": "required", "type": "string", "description": "

This value will only be available when challenge is needed, in the challenge flow - this must be passed to browser in order to trigger the challenge

", "example": "eyJhY3NUcmFuc0lEIjoiMTEyY2RiNWItMGFlYy00MTY5LThjMWYtYWMyN2JlNjAxMjhhIiwiY2hhbGxlbmdlV2luZG93U2l6ZSI6IjA0IiwibWVzc2FnZVZlcnNpb24iOiIyLjEuMCIsIm1lc3NhZ2VUeXBlIjoiQ1JlcSIsInRocmVlRFNTZXJ2ZXJUcmFuc0lEIjoiZWRhM2MwMzYtZWMyYS00NmZkLTlmYWItNzBlZTgyYjJjNzQ5In0=" }, { "name": "exemption", "kind": "optional", "type": "string", "nullable": true, "description": "Exemption that should be used during the authorization process", "example": "TRANSACTION_RISK_ANALYSIS", "enum": [ "LOW_VALUE", "TRANSACTION_RISK_ANALYSIS", "SECURE_CORPORATE", "TRUSTED_BENEFICIARY" ] }, { "name": "interactionCounter", "kind": "required", "type": "string", "description": "Indicates the number of authentication cycles attempted by the Cardholder", "example": "01", "maxLength": 2 }, { "name": "isFallback", "kind": "required", "type": "boolean", "description": "Indication of whether a 3DS1 challenge was performed as a fallback to 3DS2 error", "example": false, "maxLength": 5 }, { "name": "messageCategory", "kind": "required", "type": "string", "description": "

Identifies the category of the message for a specific use case (01 - PA, 02 - NPA)

", "example": "01", "maxLength": 2 }, { "name": "outOfScopeForPSD2", "kind": "optional", "type": "string", "nullable": true, "description": "This field indicate if transaction is out of scope for PSD2 and exclusion should be requested", "example": "ANONYMOUS_PREPAID_CARD", "enum": [ "ANONYMOUS_PREPAID_CARD", "MERCHANT_INITIATED_TRANSACTIONS", "ONE_LEG_OUT_EEA", "MAIL_ORDER_TELEPHONE_ORDER" ] }, { "name": "threeDSServerTransID", "kind": "required", "type": "string", "description": "

Universally unique transaction identifier assigned by the 3DS Server to identify a single transaction (in 3DS1 equal to XID)

", "example": "26d648a9-da8a-4f8b-a76d-094801d2fd45", "maxLength": 100 }, { "name": "threeDSecureMode", "kind": "required", "type": "string", "description": "

Indicate if the transaction is Frictionless or SCA. Being used by some payment gateways. Possible values: sca, frictionless

", "example": "sca", "maxLength": 15 }, { "name": "threeDSecurePreference", "kind": "required", "type": "string", "description": "

The challenge indicator used. Being used by some payment gateways. Possible values: nopref, frictionless, sca, scamandate

", "example": "nopref", "maxLength": 15 }, { "name": "threeDSecureResult", "kind": "required", "type": "string", "description": "This field is relevant for 3DS1 and being used by some payment gateways", "example": "590040", "maxLength": 6 }, { "name": "transStatus", "kind": "required", "type": "string", "description": "

3DS transStatus value - Indicates whether a transaction qualifies as an authenticated transaction or account verification. should be sent to the payment gateway in the authorization call (Possible values: U, N, Y, A, C, D, R, I)

", "example": "Y", "maxLength": 1 }, { "name": "transStatusReason", "kind": "required", "type": "string", "description": "

Provides information on why the Transaction Status field has the specified value. Possible values: 01-99

", "example": "01", "maxLength": 2 }, { "name": "verifyStatus", "kind": "required", "type": "string", "description": "

Cres transStatus value (Possible values: U, N, Y, A, C, D, R, I, null)

", "example": "Y", "maxLength": 1 }, { "name": "version", "kind": "required", "type": "string", "description": "

Version. Possible values: 1.0.2, 2.1.0, 2.2.0

", "example": "2.1.0", "maxLength": 50 } ] } ], "schema": [] }, { "name": "email", "kind": "optional", "type": "object", "description": "", "complexType": "allOf", "complexItems": [ { "name": "Email", "description": "", "modelRef": "#/components/schemas/Email", "schema": [ { "name": "email", "kind": "required", "type": "string", "description": "Email address", "example": "john_s@test.com", "maxLength": 256 }, { "name": "emailVerification", "kind": "required", "type": "object", "description": "

True if customer received email verification message to this address and clicked-through back to merchant's site

", "modelRef": "#/components/schemas/Verification", "customType": "Verification", "schema": [ { "name": "sent", "kind": "required", "type": "boolean", "description": "True if verification email was sent to email address or verification SMS was sent to phone number", "example": true }, { "name": "timeSent", "kind": "optional", "type": "number", "nullable": true, "description": "

Date verification email or SMS was sent in seconds since unix epoch (UTC, Jan 1, 1970)

", "example": 1389567341 }, { "name": "verified", "kind": "required", "type": "boolean", "description": "

True if customer received email verification message to this address and clicked-through back to merchant's site, or received SMS message and enterd code in merchant's site (two-factor authentication)

", "example": false } ] } ] } ], "schema": [] }, { "name": "phone", "kind": "optional", "type": "object", "description": "", "complexType": "allOf", "complexItems": [ { "name": "Phone", "description": "", "modelRef": "#/components/schemas/Phone", "schema": [ { "name": "phone", "kind": "required", "type": "string", "description": "Phone number including all country and local access codes", "example": "15557654321", "maxLength": 25 }, { "name": "smsVerified", "kind": "required", "type": "object", "description": "Phone verification details", "modelRef": "#/components/schemas/Verification", "customType": "Verification", "schema": [ { "name": "sent", "kind": "required", "type": "boolean", "description": "True if verification email was sent to email address or verification SMS was sent to phone number", "example": true }, { "name": "timeSent", "kind": "optional", "type": "number", "nullable": true, "description": "

Date verification email or SMS was sent in seconds since unix epoch (UTC, Jan 1, 1970)

", "example": 1389567341 }, { "name": "verified", "kind": "required", "type": "boolean", "description": "

True if customer received email verification message to this address and clicked-through back to merchant's site, or received SMS message and enterd code in merchant's site (two-factor authentication)

", "example": false } ] } ] } ], "schema": [] } ] } ] } ], "modelRef": "#/components/schemas/v3OrderResultsResponse", "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": "HesxgpkjEntC6VVF6uEDk", "language": "curl", "label": "cURL", "code": "curl --request POST \\\n --url https://api.forter-secure.com/v3/orders/{id}/results \\\n --header 'accept: application/json' \\\n --header 'content-type: application/json' \\\n --header 'api-version: 10.3' \\\n --header 'x-forter-siteid: a1b2c3d4e5f6' \\\n --data '{\n \"managedOrderToken\": \"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IjIwMjMtMDUtMjMifQ.eyJmb3J0ZXJPcGFxdWVEYXRhIjoiZm9ydGVyT3BhcXVlRGF0YSIsImF1ZCI6ImNoZWNrb3V0dG9vbHMiLCJpc3MiOiJodHRwczovL2FwaS5jaGVja291dHRvb2xzLmNvbS92My9tYW5hZ2VkL29yZGVycyIsImV4cCI6MTczMzk0NzYxNH0.i3Q2KsUerRNQMfCGKQgoR_0AIENOKZ0C99kiRtlkuVQqbmhPRo0A4c42XHp0J_-kdJbCW2W1WckgglTy8GGRfwzVfZ2szSxJCB6QOd4uHwn0BN1GeTdY3qjtBHF48ihsDhfYXvII4Kl2zpL54aJfCePuYANedhxAWJZnUCcSKxFDYsj-gHGGApZbgPhnMI1QfUme2CHjpxu2vGTC0xC08OQuYO7vbESQU_YnLsc-xQYBrOy_4XuOEJDq8fK2O5saiZZEknNvLxouAzn16p5lzWJ3sp-tsJR-a9C_KgNqz_Nv4SaeSYQMhJwrYXXLhNP2ueTHdzEObtm7Skp_NQFdXBBF4vMO4HhKKBzNnfWjsKKCb6Utb__AZNbW4XYn9788wdHNVu-TVhiHRYOg19iOHaJS1l8DfHqMN0o-98Cmdu9prhGIvey64FrcEoAf9jhUjT4LN9u0zuH1jbwfpG-owmHEnpAY6dtZilK81zrf6A3OhRIB5_cECdutSa_UHXP1xapUsGoQMy3T5qaecnj6VqwXI1Cc3vrhsaewRCqJqDTeHG2slttrWBrigvXk4rFwWVazn_Y_PCy-WCfcazXK6nTCJTQ_mBoM24S-W6jRlOsfplDDl5cKGrvsulqXDuDqRzJnc_AmkVOWM9AvqqgkC5ef_2xcGprFi4xDjXkScz4\"\n }'" }, { "id": "ZXBV7GjgXiTVwq-Tyeg0u", "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.3\");\nmyHeaders.append(\"x-forter-siteid\", \"a1b2c3d4e5f6\");\n\nvar raw = JSON.stringify({\n \"managedOrderToken\": \"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IjIwMjMtMDUtMjMifQ.eyJmb3J0ZXJPcGFxdWVEYXRhIjoiZm9ydGVyT3BhcXVlRGF0YSIsImF1ZCI6ImNoZWNrb3V0dG9vbHMiLCJpc3MiOiJodHRwczovL2FwaS5jaGVja291dHRvb2xzLmNvbS92My9tYW5hZ2VkL29yZGVycyIsImV4cCI6MTczMzk0NzYxNH0.i3Q2KsUerRNQMfCGKQgoR_0AIENOKZ0C99kiRtlkuVQqbmhPRo0A4c42XHp0J_-kdJbCW2W1WckgglTy8GGRfwzVfZ2szSxJCB6QOd4uHwn0BN1GeTdY3qjtBHF48ihsDhfYXvII4Kl2zpL54aJfCePuYANedhxAWJZnUCcSKxFDYsj-gHGGApZbgPhnMI1QfUme2CHjpxu2vGTC0xC08OQuYO7vbESQU_YnLsc-xQYBrOy_4XuOEJDq8fK2O5saiZZEknNvLxouAzn16p5lzWJ3sp-tsJR-a9C_KgNqz_Nv4SaeSYQMhJwrYXXLhNP2ueTHdzEObtm7Skp_NQFdXBBF4vMO4HhKKBzNnfWjsKKCb6Utb__AZNbW4XYn9788wdHNVu-TVhiHRYOg19iOHaJS1l8DfHqMN0o-98Cmdu9prhGIvey64FrcEoAf9jhUjT4LN9u0zuH1jbwfpG-owmHEnpAY6dtZilK81zrf6A3OhRIB5_cECdutSa_UHXP1xapUsGoQMy3T5qaecnj6VqwXI1Cc3vrhsaewRCqJqDTeHG2slttrWBrigvXk4rFwWVazn_Y_PCy-WCfcazXK6nTCJTQ_mBoM24S-W6jRlOsfplDDl5cKGrvsulqXDuDqRzJnc_AmkVOWM9AvqqgkC5ef_2xcGprFi4xDjXkScz4\"\n});\n\nvar requestOptions = {\n method: 'POST',\n headers: myHeaders,\n body: raw,\n redirect: 'follow'\n};\n\nfetch(\"https://api.forter-secure.com/v3/orders/{id}/results\", requestOptions)\n .then(response => response.text())\n .then(result => console.log(result))\n .catch(error => console.log('error', error));" }, { "id": "2gY21JQmdmnxXRHmfN1pN", "language": "ruby", "label": "Ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.forter-secure.com/v3/orders/{id}/results\")\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.3\"\nrequest[\"x-forter-siteid\"] = \"a1b2c3d4e5f6\"\nrequest.body = JSON.dump({\n \"managedOrderToken\": \"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IjIwMjMtMDUtMjMifQ.eyJmb3J0ZXJPcGFxdWVEYXRhIjoiZm9ydGVyT3BhcXVlRGF0YSIsImF1ZCI6ImNoZWNrb3V0dG9vbHMiLCJpc3MiOiJodHRwczovL2FwaS5jaGVja291dHRvb2xzLmNvbS92My9tYW5hZ2VkL29yZGVycyIsImV4cCI6MTczMzk0NzYxNH0.i3Q2KsUerRNQMfCGKQgoR_0AIENOKZ0C99kiRtlkuVQqbmhPRo0A4c42XHp0J_-kdJbCW2W1WckgglTy8GGRfwzVfZ2szSxJCB6QOd4uHwn0BN1GeTdY3qjtBHF48ihsDhfYXvII4Kl2zpL54aJfCePuYANedhxAWJZnUCcSKxFDYsj-gHGGApZbgPhnMI1QfUme2CHjpxu2vGTC0xC08OQuYO7vbESQU_YnLsc-xQYBrOy_4XuOEJDq8fK2O5saiZZEknNvLxouAzn16p5lzWJ3sp-tsJR-a9C_KgNqz_Nv4SaeSYQMhJwrYXXLhNP2ueTHdzEObtm7Skp_NQFdXBBF4vMO4HhKKBzNnfWjsKKCb6Utb__AZNbW4XYn9788wdHNVu-TVhiHRYOg19iOHaJS1l8DfHqMN0o-98Cmdu9prhGIvey64FrcEoAf9jhUjT4LN9u0zuH1jbwfpG-owmHEnpAY6dtZilK81zrf6A3OhRIB5_cECdutSa_UHXP1xapUsGoQMy3T5qaecnj6VqwXI1Cc3vrhsaewRCqJqDTeHG2slttrWBrigvXk4rFwWVazn_Y_PCy-WCfcazXK6nTCJTQ_mBoM24S-W6jRlOsfplDDl5cKGrvsulqXDuDqRzJnc_AmkVOWM9AvqqgkC5ef_2xcGprFi4xDjXkScz4\"\n})\n\nresponse = https.request(request)\nputs response.read_body\n" }, { "id": "afHy1BaPtZjpe461wzaC2", "language": "python", "label": "Python", "code": "import requests\nimport json\n\nurl = \"https://api.forter-secure.com/v3/orders/{id}/results\"\n\npayload = json.dumps({\n \"managedOrderToken\": \"eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6IjIwMjMtMDUtMjMifQ.eyJmb3J0ZXJPcGFxdWVEYXRhIjoiZm9ydGVyT3BhcXVlRGF0YSIsImF1ZCI6ImNoZWNrb3V0dG9vbHMiLCJpc3MiOiJodHRwczovL2FwaS5jaGVja291dHRvb2xzLmNvbS92My9tYW5hZ2VkL29yZGVycyIsImV4cCI6MTczMzk0NzYxNH0.i3Q2KsUerRNQMfCGKQgoR_0AIENOKZ0C99kiRtlkuVQqbmhPRo0A4c42XHp0J_-kdJbCW2W1WckgglTy8GGRfwzVfZ2szSxJCB6QOd4uHwn0BN1GeTdY3qjtBHF48ihsDhfYXvII4Kl2zpL54aJfCePuYANedhxAWJZnUCcSKxFDYsj-gHGGApZbgPhnMI1QfUme2CHjpxu2vGTC0xC08OQuYO7vbESQU_YnLsc-xQYBrOy_4XuOEJDq8fK2O5saiZZEknNvLxouAzn16p5lzWJ3sp-tsJR-a9C_KgNqz_Nv4SaeSYQMhJwrYXXLhNP2ueTHdzEObtm7Skp_NQFdXBBF4vMO4HhKKBzNnfWjsKKCb6Utb__AZNbW4XYn9788wdHNVu-TVhiHRYOg19iOHaJS1l8DfHqMN0o-98Cmdu9prhGIvey64FrcEoAf9jhUjT4LN9u0zuH1jbwfpG-owmHEnpAY6dtZilK81zrf6A3OhRIB5_cECdutSa_UHXP1xapUsGoQMy3T5qaecnj6VqwXI1Cc3vrhsaewRCqJqDTeHG2slttrWBrigvXk4rFwWVazn_Y_PCy-WCfcazXK6nTCJTQ_mBoM24S-W6jRlOsfplDDl5cKGrvsulqXDuDqRzJnc_AmkVOWM9AvqqgkC5ef_2xcGprFi4xDjXkScz4\"\n})\nheaders = {\n 'accept': 'application/json',\n 'content-type': 'application/json',\n 'api-version': '10.3',\n 'x-forter-siteid': 'a1b2c3d4e5f6'\n}\n\nresponse = requests.request(\"POST\", url, headers=headers, data=payload)\n\nprint(response.text)\n" } ], "selectedLanguageId": "HesxgpkjEntC6VVF6uEDk" }, "results": { "languages": [ { "id": "ApRjS5L_dKH3du5qkje2d", "language": "200", "code": "// Example v3OrderResultsResponse\n{\n \"correlationId\": \"a1b2c3d4e5f6\",\n \"decisionReason\": \"\",\n \"forterDecision\": \"APPROVE\",\n \"linkToEventInDashboard\": \"https://portal.forter.com/dashboard/:id\",\n \"merchantPolicyId\": \"0ee8ba28a8654c659addbae9253b707c\",\n \"orderId\": \"123456\",\n \"recommendation\": \"\",\n \"verificationMethod\": {\n \"correlationId\": \"HGJ7512345H3DE\",\n \"status\": \"FRICTIONLESS\",\n \"statusCode\": \"100\",\n \"statusMessage\": \"Verification code sent\",\n \"type\": \"THREE_DS\",\n \"verificationId\": \"345H3DEHGJ7512\",\n \"verificationSpecificData\": {\n \"ThreeDS\": {},\n \"email\": {},\n \"phone\": {}\n }\n }\n}" }, { "id": "uWYtonjCGxiTtbTzwOE65", "language": "400", "code": "// Bad Request (Often missing a required parameter)\n" }, { "id": "bFiYBnxgIVuNFLp07f2ej", "language": "401", "code": "// Unauthorized (No valid API key provided)\n" }, { "id": "xwwKcY6p4sUzhnW8tLnch", "language": "404", "code": "// Not Found (The requested item doesn't exist)\n" }, { "id": "lO1bYPpo_dfSPGA0AGUjs", "language": "500", "code": "// Server Error (Something went wrong on Forter's end)\n" } ], "selectedLanguageId": "ApRjS5L_dKH3du5qkje2d" } }, "children": [ { "text": "" } ] }