{"templateId":"markdown","versions":[{"version":"v1","label":"v1 (latest)","link":"/products/fraudsight/update/fraud","default":true,"active":true,"folderId":"bcec2bc6"}],"sharedDataIds":{"sidebar":"sidebar-products/fraudsight/sidebars.yaml","current-catalog-info":"current-catalog-info-/products/fraudsight/openapi","oas-products/fraudsight/@v1/openapi.yaml":"oas-products/fraudsight/@v1/openapi.yaml"},"props":{"metadata":{"markdoc":{"tagList":["partial","openapi-code-sample","json-schema","admonition"]},"custom_product":"FraudSight","type":"markdown"},"seo":{"title":"Fraud update","description":"Worldpay for Developers - docs, code examples, resources and tools. Everything you need to build your omnichannel payment solution.","siteUrl":"https://docs.worldpay.com/access","image":"/access/assets/worldpay-logo-light.21b7daf79984773a9fcd7d4fbcb07ae5289dfffd6023c4c3dca720c7058e53dc.33f780a6.svg","keywords":"documentation, api, openapi, sdks, developer, payments, json, payouts, 3ds","jsonLd":{"@context":"https://schema.org","@type":"Organization","url":"https://docs.worldpay.com/access","name":"Worldpay"},"meta":[{"name":"google-site-verification","content":"zjziIKaP3ImsqsfhYnEBnq1R85UabiSwl7HTXuwtZuo"},{"name":"doc_product","content":"Access"},{"name":"doc_category","content":"Documentation"}],"llmstxt":{"hide":false,"sections":[{"title":"Payments API","description":"Payment orchestration API combining fraud assessment, 3ds authentication, SCA exemptions, Worldpay Token creation and a card or wallet based payment.","includeFiles":["products/payments/@20240601/**/*"],"excludeFiles":[]},{"title":"Payment Queries API","description":"Querying your payments data, based on a variety of parameters.","includeFiles":["products/payment-queries/@v1/**/*"],"excludeFiles":[]},{"title":"Card BIN Data API","description":"Provides detailed information about a card.","includeFiles":["products/card-bin/@v1/**/*"],"excludeFiles":[]},{"title":"3DS Authentication API","description":"Request 3DS authentication to protect against fraud, be SCA compliant and to shift liability using this standalone API.","includeFiles":["products/3ds/@v3/**/*"],"excludeFiles":[]},{"title":"FraudSight API","description":"Request a risk assessment and receive a response with an outcome (e.g. lowRisk) using this standalone API.","includeFiles":["products/fraudsight/@v1/**/*"],"excludeFiles":[]},{"title":"Checkout SDK","description":"Integrate using our clientside SDKs for both web and native devices. Benefit from SAQ-A/PCI-SSF compliance.","includeFiles":["products/checkout/web/@v2/**/*","products/checkout/ios/@v4/**/*","products/checkout/android/@v4/**/*","products/checkout/react-native/@v3/**/*","products/checkout/flutter/@v1/**/*"],"excludeFiles":[]},{"title":"Tokens API","description":"Minimizes the exposure of sensitive card details and increases the security of your customer's card details.","includeFiles":["products/tokens/@v3/**/*"],"excludeFiles":[]},{"title":"Card Payments API","description":"Request a card payment using this standalone API, requires separate requests for 3DS, Fraud assessment etc.","includeFiles":["products/card-payments/@v7/**/*"],"excludeFiles":[]},{"title":"Card Verifications API","description":"Verify your customer's card to maximize your authentication rates.","includeFiles":["products/card-verifications/@v6/**/*"],"excludeFiles":[]},{"title":"Account Payouts API","description":"Send funds to your customer's bank accounts and search for payouts using parameters.","includeFiles":["products/account-payouts/@20250101/**/*"],"excludeFiles":[]},{"title":"APMs","description":"Pay using eWallets, bank transfers, direct debits, local card schemes, Postpay and eInvoice/ Buy Now Pay Later.","includeFiles":["products/apms/@20240701/**/*"],"excludeFiles":[]},{"title":"Balance API","description":"Request your account details for a single account or all accounts under an entity.","includeFiles":["products/balance/@20250101/**/*"],"excludeFiles":[]},{"title":"Card Payouts API","description":"Send funds to your customer's cards.","includeFiles":["products/card-payouts/@v4/**/*"],"excludeFiles":[]},{"title":"Events (Webhooks)","description":"Receive status updates from Access Worldpay by setting up a webhook.","includeFiles":["products/events/@v1/**/*"],"excludeFiles":[]},{"title":"FX API","description":"Manage Foreign Exchange (FX) on your payments.","includeFiles":["products/fx/@v1/**/*"],"excludeFiles":[]},{"title":"Hosted Payment Pages (HPP) API","description":"Our low-code option to take payments securely at the lowest PCI compliance level - SAQ A.","includeFiles":["products/hosted-payment-pages/@v1/**/*"],"excludeFiles":[]},{"title":"Money Transfers API","description":"Money Transfer OCTs (Original Credit Transaction) allow funds to be pushed to an eligible card in 30 minutes or less.","includeFiles":["products/money-transfers/@v1/**/*"],"excludeFiles":[]},{"title":"Parties API","description":"Create parties, manage your payout instruments and beneficial owners and carry out identity verification checks.","includeFiles":["products/parties/@20250101/**/*"],"excludeFiles":[]},{"title":"SCA Exemptions API","description":"Maximize a frictionless checkout experience by using issuer data insights to apply exemptions.","includeFiles":["products/sca-exemptions/@v1/**/*"],"excludeFiles":[]},{"title":"Split Payments API","description":"Divide funds from a single payment amongst yourself and your parties/sellers.","includeFiles":["products/split-payments/@20250625/**/*"],"excludeFiles":[]},{"title":"Statements API","description":"Retrieve your account statement and see individual entries for all credits and debits.","includeFiles":["products/statements/@20250101/**/*"],"excludeFiles":[]},{"title":"Transfers API","description":"Transfer funds from source account to target account.","includeFiles":["products/transfers/@20250101/**/*"],"excludeFiles":[]},{"title":"Verified Tokens API","description":"Verified Tokens ensures that your customer's payment details are valid and CIT compliant when creating a token.","includeFiles":["products/verified-tokens/@v3/**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Last updated"]},": 16 July 2026 | ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/fraudsight/changelog/"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Change log"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"fraud-update","__idx":0},"children":["Fraud update"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," your request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fraudsight:fraud"]}," action link."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fraud-update-example-request","__idx":1},"children":["Fraud update example request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["POST  ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/fraudsight/update/fraud"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fraud update request body:"]},{"$$mdtype":"Tag","name":"OpenApiCodeSample","attributes":{"descriptionFile":"oas-products/fraudsight/@v1/openapi.yaml","operationId":"updateFraud","parameters":{},"environments":{}},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"schema","__idx":2},"children":["Schema"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Full ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/fraudsight/openapi"},"children":["API Reference here"]}]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"../openapi.yaml#/components/schemas/fraudsight_updateFraud"},"options":{"hideSchemaTitles":true,"hidePropertiesPrefix":true,"schemasExpansionLevel":1},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/fraudsight_updateFraud"},"transactionReference":{"maxLength":64,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"A unique reference for authentication. For example, e-commerce order code."},"entity":{"maxLength":64,"minLength":1,"pattern":"^[A-Za-z0-9 ]*$","type":"string","description":"Used to route the request in Access Worldpay, created as part of on-boarding."},"value":{"required":["amount","currency"],"type":"object","description":"An object that contains information about the value of the assessment.","properties":{"amount":{"maximum":99999999999,"minimum":0,"type":"integer","description":"The authentication amount. This is a whole number with an exponent, e.g. if exponent is two, 250 is 2.50. You can find the relevant exponent in our [currency table](/products/reference/supported-countries-currencies#iso-currency-codes). The assessment amount should be equal to the authorization amount. We recommend you delay assessment until the amount is known, or ensure it's greater than the total transaction amount."},"currency":{"maxLength":3,"minLength":3,"pattern":"^[A-Z]{3}$","type":"string","description":"The three digit currency code. See list of [supported currencies](/products/reference/supported-countries-currencies#iso-currency-codes)."}}},"fraudsight_updateFraud":{"required":["transactionReference","merchant","riskProfile","source","sourceDate","acquirerReference","fraudReasonCode","value"],"type":"object","properties":{"transactionReference":{"$ref":"#/components/schemas/transactionReference"},"merchant":{"required":["entity"],"type":"object","description":"An object that contains information about the merchant and API level configuration.","properties":{"entity":{"$ref":"#/components/schemas/entity"}}},"riskProfile":{"maxLength":2048,"minLength":39,"type":"string","format":"uri","description":"Represents the outcome of the original fraud assessment. Used to link subsequent Fraud related requests."},"source":{"enum":["SAFE","TC40"],"type":"string","description":"Source format of confirmed fraud cases."},"sourceDate":{"maxLength":20,"type":"string","format":"date-time","description":"Date/time of source fraud file (TC40/SAFE)."},"acquirerReference":{"maxLength":128,"minLength":1,"type":"string","description":"Acquirer Reference Number (ARN) - unique value assigned to a credit or debit card transaction."},"fraudReasonCode":{"maxLength":16,"minLength":1,"type":"string","description":"Visa and Mastercard reason codes:\n\n| FraudReasonCode | FraudReasonDescription                |   |   |   |\n|-----------------|---------------------------------------|---|---|---|\n| 00              | Lost                                  |   |   |   |\n| 01              | Stolen                                |   |   |   |\n| 02              | Card not received                     |   |   |   |\n| 03              | Fraudulent application                |   |   |   |\n| 04              | Counterfeit                           |   |   |   |\n| 05              | Account Takeover                      |   |   |   |\n| 06              | Cardholder not present                |   |   |   |\n| 07              | Imprinting of multiple sale drafts    |   |   |   |\n| 08              | Other                                 |   |   |   |\n| 900             | Lost                                  |   |   |   |\n| 901             | Stolen                                |   |   |   |\n| 902             | Card not received                     |   |   |   |\n| 903             | Fraudulent application                |   |   |   |\n| 904             | Counterfeit                           |   |   |   |\n| 905             | Account Takeover                      |   |   |   |\n| 906             | Cardholder not present                |   |   |   |\n| 907             | Imprinting of multiple sale drafts    |   |   |   |\n| 908             | Other                                 |   |   |   |\n| 908             | Other                                 |   |   |   |\n| 919             | Other                                 |   |   |   |\n| A               | Incorrect Processing                  |   |   |   |\n| B               | Account or Credentials Takeover Fraud |   |   |   |"},"value":{"$ref":"#/components/schemas/value"}}}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fraud-update-responses","__idx":3},"children":["Fraud update responses"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Best practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Access Worldpay returns a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WP-CorrelationId"]}," in the headers of service responses. We ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["highly recommend"]}," you log this. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WP-CorrelationId"]}," is used by us to examine individual service requests."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response status is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200 OK"]},"."]}]},"headings":[{"value":"Fraud update","id":"fraud-update","depth":1},{"value":"Fraud update example request","id":"fraud-update-example-request","depth":2},{"value":"Schema","id":"schema","depth":2},{"value":"Fraud update responses","id":"fraud-update-responses","depth":2}],"frontmatter":{"seo":{"title":"Fraud update"}},"lastModified":"2026-02-13T11:40:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/fraudsight/update/fraud","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}