{"templateId":"markdown","versions":[{"version":"v4","label":"v4","link":"/products/card-verifications/v4/verifications","default":false,"active":true,"folderId":"17a671ff"},{"version":"v5","label":"v5","link":"/products/card-verifications/v5/verifications","default":false,"active":false,"folderId":"17a671ff"},{"version":"v6","label":"v6 (Latest)","link":"/products/card-verifications/verifications","default":true,"active":false,"folderId":"17a671ff"}],"sharedDataIds":{"sidebar":"sidebar-products/card-verifications/sidebars.yaml","current-catalog-info":"current-catalog-info-/products/card-verifications/openapi"},"props":{"metadata":{"markdoc":{"tagList":["partial","tabs","tab","code-snippet","admonition"]},"custom_product":"Card Verifications","type":"markdown"},"seo":{"title":"Verify a customer's account","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":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Last updated"]},": 11 March 2026 | ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/changelog/"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Change log"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"verify-a-customers-account","__idx":0},"children":["Verify a customer's account"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To verify your customer's account, you must send a verifications request to one of our supported resources."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"intelligent-verification","__idx":1},"children":["Intelligent verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["With an Intelligent verification, Worldpay chooses the amount to use in the verification."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"intelligent-verification-request","__idx":2},"children":["Intelligent verification request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," your intelligent verification request to one of these resources:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"onetime-intelligent-verification","__idx":3},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oneTime"]}," intelligent verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oneTime"]}," verification, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," your request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifications:oneTime"]}," action link received in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v4/get-started#query-verifications-root-resource"},"children":["query the verifications root resource"]}," request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/verifications/accounts/intelligent/oneTime"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cardonfile-intelligent-verification","__idx":4},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardOnFile"]}," intelligent verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardOnFile"]}," payments are initiated by the customer using the payment instrument details that have already been stored."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardOnFile"]}," verification, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," your request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifications:cardOnFile"]}," action link received in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v4/get-started#query-verifications-root-resource"},"children":["query the verifications root resource"]}," request to become Cardholder Initiated Transaction (CIT) compliant."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/verifications/accounts/intelligent/cardOnFile"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-body","__idx":5},"children":["Example request body"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Intelligent verification for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardOnFile"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oneTime"]}," requests:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Verification request","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/verifications-request-mandatory.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"{uniqueTransactionReference}\",\n \"currency\": \"GBP\",\n \"merchant\": {\n \"entity\": \"default\"\n },\n \"paymentInstrument\": {\n \"type\": \"card/plain\",\n \"cvc\": \"321\",\n \"cardHolderName\": \"John Appleseed\",\n \"cardNumber\": \"4444333322221111\",\n \"cardExpiryDate\": {\n \"month\": 5,\n \"year\": 2035\n },\n \"verificationAddress\": {\n \"address1\": \"Worldpay\",\n \"countryCode\": \"GB\",\n \"postalCode\": \"CB4 0WE\",\n \"city\": \"Cambridge\"\n }\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Verification request with paymentFacilitator","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/verifications-request-complete.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"{uniqueTransactionReference}\",\n \"merchant\": {\n \"entity\": \"default\",\n \"paymentFacilitator\": {\n \"pfId\": \"12345678901\",\n \"isoId\": \"4101\",\n \"subMerchant\": {\n \"merchantId\": \"873674903278364\",\n \"name\": \"Example Shop\",\n \"street\": \"123 Street\",\n \"state\": \"CA\",\n \"city\": \"San Francisco\",\n \"countryCode\": \"840\",\n \"postalCode\": \"94101\",\n \"taxId\": \"987-65-4321\",\n \"telephone\": \"800-555-9999\",\n \"email\": \"contact@example.com\",\n \"url\": \"developer.worldpay.com\"\n }\n }\n },\n \"currency\": \"GBP\",\n \"paymentInstrument\": {\n \"type\": \"card/plain\",\n \"cardNumber\": \"4444333322221111\",\n \"cardHolderName\": \"John Appleseed\",\n \"cardExpiryDate\": {\n \"month\": 5,\n \"year\": 2035\n },\n \"verificationAddress\": {\n \"address1\": \"address1\",\n \"postalCode\": \"aaaa\",\n \"city\": \"city\",\n \"countryCode\": \"GB\"\n },\n \"cvc\": \"123\"\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Verification request with token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/intelligent-request-onetime-token.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"{uniqueTransactionReference}\",\n \"currency\": \"GBP\",\n \"merchant\": {\n \"entity\": \"default\"\n },\n \"paymentInstrument\": {\n \"type\": \"card/tokenized\",\n \"href\": \"https://try.access.worldpay.com/tokens/{}\"\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Intelligent verification request with paymentFacilitator"]}," if you are a payment facilitator."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Descriptions of your intelligent verification request parameters:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The 3-digit currency code.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"See list of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/supported-countries-currencies#iso-currency-codes"},"children":["supported currencies"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionReference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["unique"]}," reference generated by you that is used to identify a payment throughout its lifecycle. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/formatting#transaction-reference-format"},"children":["transaction reference format"]},", for more details and the best practices."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's payment details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardHolderName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's payment card number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's payment type, card/plain."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.verificationAddress"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object containing the verification address information. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If included you must send"]}," at least: ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["countryCode"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postalCode"]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardExpiryDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's payment card expiry date."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cvc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CVC is a unique set of 3 or 4 numbers on the back of your customer's card. Including the CVC in your request increases the chances of the verification request ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outcome"]}," being ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verified"]},". Our API checks to see if the CVC supplied matches the CVC held by the issuing bank."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains information about the merchant."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant.entity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Direct your verification to assist with billing, reporting and reconciliation. This is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["mandatory"]}," for verifications. For more information contact your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.worldpay.com/en-GB/merchant-support#still-need-help"},"children":["Relationship Manager or Worldpay Implementation Manager"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant.mcc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A Merchant Category Code (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcc"]},") can be applied to an individual request. An ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcc"]}," can only be provided if the dynamic ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcc"]}," feature has been enabled during ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.worldpay.com/en-GB/merchant-support#still-need-help"},"children":["boarding"]},". If enabled but not provided, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant.mcc"]}," defaults to a configured value. For more information contact your Relationship Manager or Worldpay Implementation Manager."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant.paymentFacilitator"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object containing your payment facilitator information. If required you must send:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["pfId"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["isoId"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["subMerchant.merchantId"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["subMerchant.postalcode"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["subMerchant.street"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["subMerchant.city"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["subMerchant.countryCode"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["subMerchant.url"]}]},"This information is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["only"]}," required for verification if you are a payment facilitator."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipient"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains the details of the recipient of the payment.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accountReference"]},": Partial account number"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastName"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dateOfBirth.day"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dateOfBirth.month"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dateOfBirth.year"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address.postalCode"]}]}]}," ",{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Recommendation"},"children":[" We highly recommend you supply this, if your MCC is 6012 or 6051. Sending this field ensures you remain PSD2 compliant and avoid potential acquirer refusals. "]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"dynamic-verification","__idx":6},"children":["Dynamic verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Our Dynamic verifications service gives you granular control over the amount that is used for verification."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"dynamic-verification-request","__idx":7},"children":["Dynamic verification request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," your verification request to one of these resources :"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"dynamiconetime-verification","__idx":8},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dynamicOneTime"]}," verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dynamicOneTime"]}," verification, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," your request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifications:dynamicOneTime"]}," action link received in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v4/get-started#query-verifications-root-resource"},"children":["query the verifications root resource"]}," request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/verifications/accounts/dynamic/oneTime"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"dynamiccardonfile-verification","__idx":9},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dynamicCardOnFile"]}," verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardOnFile"]}," payments are initiated by the customer using the payment instrument details that have already been stored."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dynamicCardOnFile"]}," verification, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," your request to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifications:dynamicCardOnFile"]}," action link received in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v4/get-started#query-verifications-root-resource"},"children":["query the verifications root resource"]}," request to become Cardholder Initiated Transaction (CIT) compliant."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/verifications/accounts/dynamic/cardOnFile"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-request-body-1","__idx":10},"children":["Example request body"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Dynamic verification for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardOnFile"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["oneTime"]}," requests:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Verification request","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/dynamic-verifications-request-mandatory.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"unique-transactionReference\",\n \"merchant\": {\n \"entity\": \"default\"\n },\n \"instruction\": {\n \"value\": {\n \"currency\": \"GBP\",\n \"amount\": 20\n },\n \"paymentInstrument\": {\n \"type\": \"card/plain\",\n \"cvc\": \"321\",\n \"cardHolderName\": \"John Appleseed\",\n \"cardNumber\": \"4444333322221111\",\n \"cardExpiryDate\": {\n \"month\": 5,\n \"year\": 2035\n },\n \"verificationAddress\": {\n \"address1\": \"Worldpay\",\n \"countryCode\": \"GB\",\n \"postalCode\": \"CB4 0WE\",\n \"city\": \"Cambridge\"\n }\n }\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Verification request with paymentFacilitator","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/dynamic-verifications-request-complete.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"unique-transactionReference\",\n \"merchant\": {\n \"entity\": \"default\",\n \"mcc\": \"6012\",\n \"paymentFacilitator\": {\n \"pfId\": \"12345678901\",\n \"isoId\": \"4101\",\n \"subMerchant\": {\n \"merchantId\": \"873674903278364\",\n \"name\": \"Example Shop\",\n \"street\": \"123 Street\",\n \"state\": \"CA\",\n \"city\": \"San Francisco\",\n \"countryCode\": \"840\",\n \"postalCode\": \"94101\",\n \"taxId\": \"987-65-4321\",\n \"telephone\": \"800-555-9999\",\n \"email\": \"contact@example.com\",\n \"url\": \"developer.worldpay.com\"\n }\n }\n },\n \"instruction\": {\n \"value\": {\n \"currency\": \"GBP\",\n \"amount\": 20\n },\n \"paymentInstrument\": {\n \"type\": \"card/plain\",\n \"cvc\": \"321\",\n \"cardHolderName\": \"John Appleseed\",\n \"cardNumber\": \"4444333322221111\",\n \"cardExpiryDate\": {\n \"month\": 5,\n \"year\": 2035\n },\n \"verificationAddress\": {\n \"address1\": \"Worldpay\",\n \"countryCode\": \"GB\",\n \"postalCode\": \"CB4 0WE\",\n \"city\": \"Cambridge\"\n }\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Verification request with token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/dynamic-request-onetime-token.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"unique-transactionReference\",\n \"merchant\": {\n \"entity\": \"default\"\n },\n \"instruction\": {\n \"value\": {\n \"currency\": \"GBP\",\n \"amount\": 20\n },\n \"paymentInstrument\": {\n \"type\": \"card/tokenized\",\n \"href\": \"https://try.access.worldpay.com/tokens/{}}\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Dynamic verification request with paymentFacilitator"]}," if you are a payment facilitator."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Descriptions of your dynamic verification request parameters:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains all the information related to the payment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value.currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The 3-digit currency code.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"See list of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/supported-countries-currencies#iso-currency-codes"},"children":["supported currencies"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value.amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment 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 ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/supported-countries-currencies#iso-currency-codes"},"children":["currency table"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionReference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["unique"]}," reference generated by you that is used to identify a payment throughout its lifecycle. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/formatting#transaction-reference-format"},"children":["transaction reference format"]},", for more details and the best practices."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's payment details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardHolderName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardNumber"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's payment card number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's payment type, card/plain."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.verificationAddress"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object containing the verification address information. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["If included you must send"]}," at least: ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["countryCode"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postalCode"]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardExpiryDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's payment card expiry date."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cvc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CVC is a unique set of 3 or 4 numbers on the back of your customer's card. Including the CVC in your request increases the chances of the verification request ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outcome"]}," being ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verified"]},". Our API checks to see if the CVC supplied matches the CVC held by the issuing bank."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains information about the merchant."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant.entity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Direct your verification to assist with billing, reporting and reconciliation. This is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["mandatory"]}," for verifications. For more information contact your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.worldpay.com/en-GB/merchant-support#still-need-help"},"children":["Relationship Manager"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant.mcc"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A Merchant Category Code (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcc"]},") can be applied to an individual request. An ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mcc"]}," can only be provided if the dynamic mcc feature has been enabled during ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.worldpay.com/en-GB/merchant-support#still-need-help"},"children":["boarding"]},". If enabled but not provided, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant.mcc"]}," defaults to a configured value. For more information contact your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.worldpay.com/en-GB/merchant-support#still-need-help"},"children":["Relationship Manager"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant.paymentFacilitator"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object containing your payment facilitator information. If required you must send:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["pfId"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["isoId"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["subMerchant.merchantId"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["subMerchant.postalcode"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["subMerchant.street"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["subMerchant.city"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["subMerchant.countryCode"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["subMerchant.url"]}]},"This information is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["only"]}," required for verification if you are a payment facilitator."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipient"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains the details of the recipient of the payment.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accountReference"]},": Partial account number"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastName"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dateOfBirth.day"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dateOfBirth.month"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dateOfBirth.year"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address.postalCode"]}]}]}," ",{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Recommendation"},"children":[" We highly recommend you supply this, if your MCC is 6012 or 6051. Sending this field ensures you remain PSD2 compliant and avoid potential acquirer refusals. "]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"3ds","__idx":11},"children":["3DS"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can optionally submit 3DS parameters for intelligent and dynamic verification requests."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To get the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer"]}," authentication object you must complete an ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/web/authentication"},"children":["authentication request"]}," using our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds"},"children":["3DS API"]},"."]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Intelligent verification example request"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Intelligent verification with 3DS1","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/intelligent-verifications-request-3ds1.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"{uniqueTransactionReference}\",\n \"currency\": \"GBP\",\n \"merchant\": {\n \"entity\": \"default\",\n \"mcc\": \"6012\",\n \"paymentFacilitator\": {\n \"pfId\": \"12345678901\",\n \"isoId\": \"4101\",\n \"subMerchant\": {\n \"merchantId\": \"873674903278364\",\n \"name\": \"Example Shop\",\n \"street\": \"123 Street\",\n \"state\": \"CA\",\n \"city\": \"San Francisco\",\n \"countryCode\": \"840\",\n \"postalCode\": \"94101\",\n \"taxId\": \"987-65-4321\",\n \"telephone\": \"800-555-9999\",\n \"email\": \"contact@example.com\",\n \"url\": \"developer.worldpay.com\"\n }\n }\n },\n \"paymentInstrument\": {\n \"type\": \"card/plain\",\n \"cvc\": \"321\",\n \"cardHolderName\": \"John Appleseed\",\n \"cardNumber\": \"4444333322221111\",\n \"cardExpiryDate\": {\n \"month\": 5,\n \"year\": 2035\n },\n \"verificationAddress\": {\n \"address1\": \"Worldpay\",\n \"countryCode\": \"GB\",\n \"postalCode\": \"CB4 0WE\",\n \"city\": \"Cambridge\"\n }\n },\n \"customer\": {\n \"authentication\": {\n \"version\": \"1.0.2\",\n \"type\": \"3DS\",\n \"eci\": \"05\",\n \"authenticationValue\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\",\n \"transactionId\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Intelligent verification with 3DS2","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/intelligent-verifications-request-3ds2.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"{uniqueTransactionReference}\",\n \"currency\": \"GBP\",\n \"merchant\": {\n \"entity\": \"default\",\n \"mcc\": \"6012\",\n \"paymentFacilitator\": {\n \"pfId\": \"12345678901\",\n \"isoId\": \"4101\",\n \"subMerchant\": {\n \"merchantId\": \"873674903278364\",\n \"name\": \"Example Shop\",\n \"street\": \"123 Street\",\n \"state\": \"CA\",\n \"city\": \"San Francisco\",\n \"countryCode\": \"840\",\n \"postalCode\": \"94101\",\n \"taxId\": \"987-65-4321\",\n \"telephone\": \"800-555-9999\",\n \"email\": \"contact@example.com\",\n \"url\": \"developer.worldpay.com\"\n }\n }\n },\n \"paymentInstrument\": {\n \"type\": \"card/plain\",\n \"cvc\": \"321\",\n \"cardHolderName\": \"John Appleseed\",\n \"cardNumber\": \"4444333322221111\",\n \"cardExpiryDate\": {\n \"month\": 5,\n \"year\": 2035\n },\n \"verificationAddress\": {\n \"address1\": \"Worldpay\",\n \"countryCode\": \"GB\",\n \"postalCode\": \"CB4 0WE\",\n \"city\": \"Cambridge\"\n }\n },\n \"customer\": {\n \"authentication\": {\n \"version\": \"2.1.0\",\n \"type\": \"3DS\",\n \"eci\": \"05\",\n \"authenticationValue\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\",\n \"transactionId\": \"683001f5-3805-423a-b580-638e4b2093b3\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Intelligent verification with 3DS1 and token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/intelligent-verifications-request-3ds1-tokens.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"{uniqueTransactionReference}\",\n \"currency\": \"GBP\",\n \"merchant\": {\n \"entity\": \"default\"\n },\n \"paymentInstrument\": {\n \"type\": \"card/tokenized\",\n \"href\": \"https://try.access.worldpay.com/tokens/{}\"\n },\n \"customer\": {\n \"authentication\": {\n \"version\": \"1.0.2\",\n \"type\": \"3DS\",\n \"eci\": \"05\",\n \"authenticationValue\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\",\n \"transactionId\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Intelligent verification with 3DS2 and token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/intelligent-verifications-request-3ds1-tokens.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"{uniqueTransactionReference}\",\n \"currency\": \"GBP\",\n \"merchant\": {\n \"entity\": \"default\"\n },\n \"paymentInstrument\": {\n \"type\": \"card/tokenized\",\n \"href\": \"https://try.access.worldpay.com/tokens/{}\"\n },\n \"customer\": {\n \"authentication\": {\n \"version\": \"1.0.2\",\n \"type\": \"3DS\",\n \"eci\": \"05\",\n \"authenticationValue\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\",\n \"transactionId\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Dynamic verification example request"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Dynamic verification with 3DS1","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/dynamic-verifications-request-3ds1.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"unique-transactionReference\",\n \"merchant\": {\n \"entity\": \"default\",\n \"mcc\": \"6012\",\n \"paymentFacilitator\": {\n \"pfId\": \"12345678901\",\n \"isoId\": \"4101\",\n \"subMerchant\": {\n \"merchantId\": \"873674903278364\",\n \"name\": \"Example Shop\",\n \"street\": \"123 Street\",\n \"state\": \"CA\",\n \"city\": \"San Francisco\",\n \"countryCode\": \"840\",\n \"postalCode\": \"94101\",\n \"taxId\": \"987-65-4321\",\n \"telephone\": \"800-555-9999\",\n \"email\": \"contact@example.com\",\n \"url\": \"developer.worldpay.com\"\n }\n }\n },\n \"instruction\": {\n \"value\": {\n \"currency\": \"GBP\",\n \"amount\": 20\n },\n \"paymentInstrument\": {\n \"type\": \"card/plain\",\n \"cvc\": \"321\",\n \"cardHolderName\": \"John Appleseed\",\n \"cardNumber\": \"4444333322221111\",\n \"cardExpiryDate\": {\n \"month\": 5,\n \"year\": 2035\n },\n \"verificationAddress\": {\n \"address1\": \"Worldpay\",\n \"countryCode\": \"GB\",\n \"postalCode\": \"CB4 0WE\",\n \"city\": \"Cambridge\"\n }\n }\n },\n \"customer\": {\n \"authentication\": {\n \"version\": \"1.0.2\",\n \"type\": \"3DS\",\n \"eci\": \"05\",\n \"authenticationValue\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\",\n \"transactionId\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Dynamic verification with 3DS2","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/dynamic-verifications-request-3ds2.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"unique-transactionReference\",\n \"merchant\": {\n \"entity\": \"default\",\n \"mcc\": \"6012\",\n \"paymentFacilitator\": {\n \"pfId\": \"12345678901\",\n \"isoId\": \"4101\",\n \"subMerchant\": {\n \"merchantId\": \"873674903278364\",\n \"name\": \"Example Shop\",\n \"street\": \"123 Street\",\n \"state\": \"CA\",\n \"city\": \"San Francisco\",\n \"countryCode\": \"840\",\n \"postalCode\": \"94101\",\n \"taxId\": \"987-65-4321\",\n \"telephone\": \"800-555-9999\",\n \"email\": \"contact@example.com\",\n \"url\": \"developer.worldpay.com\"\n }\n }\n },\n \"instruction\": {\n \"value\": {\n \"currency\": \"GBP\",\n \"amount\": 20\n },\n \"paymentInstrument\": {\n \"type\": \"card/plain\",\n \"cvc\": \"321\",\n \"cardHolderName\": \"John Appleseed\",\n \"cardNumber\": \"4444333322221111\",\n \"cardExpiryDate\": {\n \"month\": 5,\n \"year\": 2035\n },\n \"verificationAddress\": {\n \"address1\": \"Worldpay\",\n \"countryCode\": \"GB\",\n \"postalCode\": \"CB4 0WE\",\n \"city\": \"Cambridge\"\n }\n }\n },\n \"customer\": {\n \"authentication\": {\n \"version\": \"2.1.0\",\n \"type\": \"3DS\",\n \"eci\": \"05\",\n \"authenticationValue\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\",\n \"transactionId\": \"683001f5-3805-423a-b580-638e4b2093b3\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Dynamic verification with 3DS1 and token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/dynamic-verifications-request-3ds1-tokens.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"unique-transactionReference\",\n \"merchant\": {\n \"entity\": \"default\"\n },\n \"instruction\": {\n \"value\": {\n \"currency\": \"GBP\",\n \"amount\": 20\n },\n \"paymentInstrument\": {\n \"type\": \"card/tokenized\",\n \"href\": \"https://try.access.worldpay.com/tokens/{}}\"\n }\n },\n \"customer\": {\n \"authentication\": {\n \"version\": \"1.0.2\",\n \"type\": \"3DS\",\n \"eci\": \"05\",\n \"authenticationValue\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\",\n \"transactionId\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Dynamic verification with 3DS2 and token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/dynamic-verifications-request-3ds2-tokens.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"unique-transactionReference\",\n \"merchant\": {\n \"entity\": \"default\"\n },\n \"instruction\": {\n \"value\": {\n \"currency\": \"GBP\",\n \"amount\": 20\n },\n \"paymentInstrument\": {\n \"type\": \"card/tokenized\",\n \"href\": \"https://try.access.worldpay.com/tokens/{}}\"\n }\n },\n \"customer\": {\n \"authentication\": {\n \"version\": \"2.1.0\",\n \"type\": \"3DS\",\n \"eci\": \"05\",\n \"authenticationValue\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\",\n \"transactionId\": \"683001f5-3805-423a-b580-638e4b2093b3\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"the-descriptions-of-parameters-from-your-3ds-authorization-request","__idx":12},"children":["The descriptions of parameters from your 3DS authorization request"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object containing the result of your customer's verification. For more details see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/web/challenge-verification#verification"},"children":["3DS verification"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3DS"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.version"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The version of 3DS used to process the transaction.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"For 3DS1 - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1.0.2"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"For 3DS2 - ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2.1.0"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2.2.0"]}," ",{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[" Required for Mastercard's Identity Check transactions in Authorization."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.eci"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Electronic Commerce Indicator (ECI).",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Indicates the outcome of the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/3ds/web/challenge-verification#verification"},"children":["3DS verification"]},".",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["02 or 05 - Fully Authenticated Transaction"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["01 or 06 - Attempted Authentication Transaction"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["00 or 07 - Non 3-D Secure Transaction"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mastercard"]}," - 02, 01, 00"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Visa"]}," - 05, 06, 07"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Amex"]}," - 05, 06, 07"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["JCB"]}," - 05, 06, 07"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Diners"]}," - 05, 06, 07"]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.authenticationValue"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A cryptographic value that provides evidence of the outcome of a 3DS verification.",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Visa - Cardholder Authentication Verification Value (CAVV)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Mastercard - Universal Cardholder Authentication Field (UCAF)"]}]},"For version 3DS1: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.authenticationValue"]}," is required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.eci"]}," value is 01, 02 or 05",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"For version 3DS2: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.authenticationValue"]}," is required if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.eci"]}," value is 01, 02, 05 or 06.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.authenticationValue"]}," must be 28 digits max and must be base64-encoded."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.transactionId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Required, if ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.eci"]}," value is 01, 02, 05 or 06.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"A unique authentication transaction identifier, generated by the issuer.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"For version 3DS1: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionId"]}," must be base64-encoded and 28 digits in length.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"For version 3DS2: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionId"]}," must be a UUID and 36 characters in length."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"apple-pay-decrypted","__idx":13},"children":["Apple Pay decrypted"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can optionally submit Apple Pay decrypted parameters for intelligent and dynamic ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardOnFile"]}," requests."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"verification-example-request","__idx":14},"children":["Verification example request:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Intelligent verification with Apple Pay decrypted","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/intelligent-verifications-request-applepay.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"currency\":\"EUR\",\n \"paymentInstrument\":{\n \"type\":\"card/networkToken+applepay\",\n \"cardHolderName\":\"Joe Bloggs\",\n \"cardExpiryDate\":{\n \"month\":1,\n \"year\":2019\n },\n \"dpan\":\"4444333322221111\"\n },\n \"merchant\":{\n \"entity\":\"default\"\n },\n \"transactionReference\":\"transactionReference\",\n \"customer\":{\n \"authentication\":{\n \"type\":\"card/networkToken\",\n \"eci\":\"05\",\n \"authenticationValue\":\"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Dynamic verification with Apple Pay decrypted","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/dynamic-verifications-request-applepay.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"merchant\":{\n \"entity\":\"default\"\n },\n \"transactionReference\":\"transactionReference\",\n \"instruction\":{\n \"value\":{\n \"amount\":100,\n \"currency\":\"GBP\"\n },\n \"paymentInstrument\":{\n \"type\":\"card/networkToken+applepay\",\n \"cardHolderName\":\"Joe Bloggs\",\n \"cardExpiryDate\":{\n \"month\":1,\n \"year\":2019\n },\n \"dpan\":\"4444333322221111\"\n }\n },\n \"customer\":{\n \"authentication\":{\n \"type\":\"card/networkToken\",\n \"eci\":\"05\",\n \"authenticationValue\":\"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Dynamic verification with 3DS1 and token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/dynamic-verifications-request-3ds1-tokens.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"unique-transactionReference\",\n \"merchant\": {\n \"entity\": \"default\"\n },\n \"instruction\": {\n \"value\": {\n \"currency\": \"GBP\",\n \"amount\": 20\n },\n \"paymentInstrument\": {\n \"type\": \"card/tokenized\",\n \"href\": \"https://try.access.worldpay.com/tokens/{}}\"\n }\n },\n \"customer\": {\n \"authentication\": {\n \"version\": \"1.0.2\",\n \"type\": \"3DS\",\n \"eci\": \"05\",\n \"authenticationValue\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\",\n \"transactionId\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Dynamic verification with 3DS2 and token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/dynamic-verifications-request-3ds2-tokens.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"transactionReference\": \"unique-transactionReference\",\n \"merchant\": {\n \"entity\": \"default\"\n },\n \"instruction\": {\n \"value\": {\n \"currency\": \"GBP\",\n \"amount\": 20\n },\n \"paymentInstrument\": {\n \"type\": \"card/tokenized\",\n \"href\": \"https://try.access.worldpay.com/tokens/{}}\"\n }\n },\n \"customer\": {\n \"authentication\": {\n \"version\": \"2.1.0\",\n \"type\": \"3DS\",\n \"eci\": \"05\",\n \"authenticationValue\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\",\n \"transactionId\": \"683001f5-3805-423a-b580-638e4b2093b3\"\n }\n },\n \"recipient\": {\n \"accountReference\": \"azAZ0123\",\n \"lastName\": \"Moriarty\",\n \"address\": {\n \"postalCode\": \"DH1 3LE\"\n },\n \"dateOfBirth\": {\n \"day\": 1,\n \"month\": 2,\n \"year\": 2000\n }\n }\n}"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"the-descriptions-of-parameters-from-your-apple-pay-decrypted-authorization-request","__idx":15},"children":["The descriptions of parameters from your Apple Pay decrypted authorization request"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's payment type; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/networkToken+applepay"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.dpan"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains the device primary account number."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object containing the authentication information required for Apple Pay decrypted."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/networkToken"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.eci"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Electronic Commerce Indicator (ECI).",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Indicates the value contained in the Apple Pay decrypted response."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.authenticationValue"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A cryptographic value that provides evidence of the outcome of a Apple Pay decrypted verification."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We currently don't return action links in our response for this ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]},". This is still under development. You can use our ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payments:migrateCardOnFileAuthorize"]}," action link to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorise-a-cardonfile-payment#-migratecardonfile-authorization-request"},"children":["take a payment"]}," in the meantime."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"verifications-response","__idx":16},"children":["Verifications response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response is the same for both an ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#intelligent-verification"},"children":["Intelligent"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#dynamic-verification"},"children":["Dynamic"]}," verification."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You receive:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201"]}," HTTP response code"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a verification ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outcome"]}," (either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verified"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not verified"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#risk-factors"},"children":["riskFactors"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}," contains the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.type"]}," sent in the request at minimum. If you wish to receive more card metadata this must be enabled. For more information contact your Worldpay Implementation Manager."]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Verified (oneTime)","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/verifications-response-verified.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"outcome\": \"verified\",\n \"checkedAt\": \"2018-09-01T10:37:36.923Z\",\n \"riskFactors\": [{\n \"risk\": \"matched\",\n \"type\": \"cvc\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"postcode\",\n \"type\": \"avs\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"address\",\n \"type\": \"avs\"\n }\n ],\n \"_links\": {\n \"verifications:verification\": {\n \"href\": \"https://try.access.worldpay.com/verifications/accounts/{resource}\"\n },\n \"curies\": [{\n \"name\": \"verifications\",\n \"href\": \"https://try.access.worldpay.com/rels/verifications/accounts/{rel}\",\n \"templated\": true\n }]\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Not verified (oneTime)","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/verifications-response-not-verified.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"outcome\": \"not verified\",\n \"code\": \"106\",\n \"rawCode\": \"N7\",\n \"description\": \"INVALID ACCOUNT\",\n \"checkedAt\": \"2019-11-01T10:37:36.923Z\",\n \"riskFactors\": [{\n \"risk\": \"matched\",\n \"type\": \"cvc\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"postcode\",\n \"type\": \"avs\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"address\",\n \"type\": \"avs\"\n }\n ],\n \"_links\": {\n \"verifications:verification\": {\n \"href\": \"https://try.access.worldpay.com/verifications/accounts/{resource}\"\n },\n \"curies\": [{\n \"name\": \"verifications:verification\",\n \"href\": \"https://try.access.worldpay.com/rels/verifications/accounts/{rel}\",\n \"templated\": true\n }]\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Verified (cardOnFile)","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/verifications-response-verified-cof.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"outcome\": \"verified\",\n \"checkedAt\": \"2019-11-01T10:37:36.923Z\",\n \"schemeTransactionReference\": \"000000000000020005060720116005060\",\n \"riskFactors\": [{\n \"risk\": \"matched\",\n \"type\": \"cvc\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"postcode\",\n \"type\": \"avs\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"address\",\n \"type\": \"avs\"\n }\n ],\n \"_links\": {\n \"verifications:verification\": {\n \"href\": \"https://try.access.worldpay.com/verifications/accounts/{resource}\"\n },\n \"payments:cardonFileAuthorize\": {\n \"href\": \"https://try.access.worldpay.com/payments/authorizations/cardonFile/{resource}\"\n },\n \"payments:recurringAuthorize\": {\n \"href\": \"http://try.access.worldpay.com/payments/authorizations/recurring/{resource}\"\n },\n \"payments:recurringSale\": {\n \"href\": \"https://try.access.worldpay.com/payments/sales/recurring/{resource}\"\n },\n \"curies\": [{\n \"name\": \"verifications:verification\",\n \"href\": \"https://try.access.worldpay.com/rels/verifications/accounts/{rel}\",\n \"templated\": true\n }]\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Not verified (cardOnFile)","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/verifications-response-not-verified-cof.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"outcome\": \"not verified\",\n \"code\": \"106\",\n \"rawCode\": \"N7\",\n \"description\": \"INVALID ACCOUNT\",\n \"checkedAt\": \"2019-11-01T10:37:36.923Z\",\n \"riskFactors\": [{\n \"risk\": \"matched\",\n \"type\": \"cvc\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"postcode\",\n \"type\": \"avs\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"address\",\n \"type\": \"avs\"\n }\n ],\n \"_links\": {\n \"verifications:verification\": {\n \"href\": \"https://try.access.worldpay.com/verifications/accounts/{resource}\"\n },\n \"curies\": [{\n \"name\": \"verifications:verification\",\n \"href\": \"https://try.access.worldpay.com/rels/verifications/accounts/{rel}\",\n \"templated\": true\n }]\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Verified with metadata (oneTime)","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/verifications-response-verified-metadata.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"outcome\": \"verified\",\n \"checkedAt\": \"2018-09-01T10:37:36.923Z\",\n \"riskFactors\": [{\n \"risk\": \"matched\",\n \"type\": \"cvc\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"postcode\",\n \"type\": \"avs\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"address\",\n \"type\": \"avs\"\n }\n ],\n \"paymentInstrument\": {\n \"type\": \"card/plain\",\n \"card\": {\n \"number\": {\n \"bin\": \"444433\",\n \"last4Digits\": \"1111\"\n },\n \"countryCode\": \"GB\",\n \"expiryDate\": {\n \"month\": 12,\n \"year\": 2029\n },\n \"brand\": \"visa\",\n \"fundingType\": \"debit\",\n \"issuer\": {\n \"name\": \"cardIssuer\"\n },\n \"category\": \"consumer\",\n \"paymentAccountReference\": \"reference\"\n }\n },\n \"_links\": {\n \"verifications:verification\": {\n \"href\": \"https://try.access.worldpay.com/verifications/accounts/{resource}\"\n },\n \"curies\": [{\n \"name\": \"verifications\",\n \"href\": \"https://try.access.worldpay.com/rels/verifications/accounts/{rel}\",\n \"templated\": true\n }]\n }\n}"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The parameter ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkedAt"]}," contains a timestamp showing when the verification was performed, and the location of the verification for future access."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Best practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you receive an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outcome"]}," of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not verified"]}," it means that your customer has failed the verification. We ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["strongly recommend that you refuse the payment"]}," made with that payment instrument."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action Link (resources)"},"children":["Action Link (resources)"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifications:verification"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The link to the outcome of your verification request."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorise-a-recurring-payment"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payments:recurringAuthorize"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A subsequent payment in a recurring agreement. This resource is only returned as a result of a successful ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v4/verifications#-recurring-verification"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifications:cardOnFile"]}]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v4/verifications#dynamic-verification"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifications:dynamicCardOnFile"]}]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorise-a-recurring-payment#recurring-authorization-without-verification"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payments:migrateRecurringAuthorize"]}]}," request."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorise-a-cardonfile-payment"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payments:cardOnFileAuthorize"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A subsequent payment in a card on file agreement. This resource is only returned as a result of a successful ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v4/verifications#-cardonfile-verification"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifications:cardOnFile"]}]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v4/verifications#dynamic-verification"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifications:dynamicCardOnFile"]}]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorise-a-cardonfile-payment#card-on-file-without-verification-authorization-request"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payments:migrateCardOnFileAuthorize"]}]}," request."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/take-a-sale"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payments:recurringSale"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A subsequent payment in a recurring agreement. This resource is only returned as a result of a successful ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v4/verifications#-cardonfile-verification"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifications:cardOnFile"]}]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-verifications/v4/verifications#dynamic-verification"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifications:dynamicCardOnFile"]}]}," request."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"risk-factors","__idx":17},"children":["Risk Factors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend you supply ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvc"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verificationAddress"]}," to increase probability of a successful verification."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The table below describes the response parameters:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["riskFactors.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["avs"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvc"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["riskFactors.detail"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["For ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["avs"]}," only.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["postcode"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["riskFactors.risk"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_checked"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_matched"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_supplied"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["matched"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"payment-instrument","__idx":18},"children":["Payment Instrument"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We only return the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}," card metadata if you are enabled for this feature."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The table below describes the response parameters:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.type"]}," provided in your request. Can be either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/plain"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/tokenized"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.card"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object containing all the additional metadata for the card/token provided in the request."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.card.number"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object containing the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["bin"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["last4Digits"]}," of the card."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.card.countryCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The country code of the card issuer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.card.expiryDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains your customer's payment card expiry date."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.card.brand"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The card scheme, e.g. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["visa"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mastercard"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.card.fundingType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Can be either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["debit"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credit"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargeCard"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prepaid"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deferredDebit"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.card.issuer.name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The name of the card issuer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.card.category"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Can be either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consumer"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commercial"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.card.paymentAccountReference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The unique reference associated with the card PAN."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"location-storing","__idx":19},"children":["Location storing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["must"]}," store the returned location information. Failing to store the location information means the outcome of the verification is lost. You are not able to query a historic verification."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The location is stored in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["href"]}," of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verifications:verification"]}," action link received on your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#verifications-response"},"children":["verifications response"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Best practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We recommend you store all responses."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"query-a-historic-verification","__idx":20},"children":["Query a historic verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To query a historic verification, submit a query to the location returned in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#verifications-response"},"children":["initial response"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"query-verifications-request","__idx":21},"children":["Query verifications request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://try.access.worldpay.com/verifications/accounts/{resource}"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can query the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#location-storing"},"children":["location"]}," that was returned in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#verifications-response"},"children":["initial response"]}," to retrieve the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outcome"]}," of the initial verification. You can ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["only"]}," get the location from the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#verifications-response"},"children":["initial response"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"query-verifications-response","__idx":22},"children":["Query verifications response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In your response is a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200"]}," HTTP response code and the historic ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outcome"]}," of the verification."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["outcome"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verified"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not verified"]}]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Verified (oneTime)","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/verifications-response-verified.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"outcome\": \"verified\",\n \"checkedAt\": \"2018-09-01T10:37:36.923Z\",\n \"riskFactors\": [{\n \"risk\": \"matched\",\n \"type\": \"cvc\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"postcode\",\n \"type\": \"avs\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"address\",\n \"type\": \"avs\"\n }\n ],\n \"_links\": {\n \"verifications:verification\": {\n \"href\": \"https://try.access.worldpay.com/verifications/accounts/{resource}\"\n },\n \"curies\": [{\n \"name\": \"verifications\",\n \"href\": \"https://try.access.worldpay.com/rels/verifications/accounts/{rel}\",\n \"templated\": true\n }]\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Not verified (oneTime)","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/verifications-response-not-verified.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"outcome\": \"not verified\",\n \"code\": \"106\",\n \"rawCode\": \"N7\",\n \"description\": \"INVALID ACCOUNT\",\n \"checkedAt\": \"2019-11-01T10:37:36.923Z\",\n \"riskFactors\": [{\n \"risk\": \"matched\",\n \"type\": \"cvc\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"postcode\",\n \"type\": \"avs\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"address\",\n \"type\": \"avs\"\n }\n ],\n \"_links\": {\n \"verifications:verification\": {\n \"href\": \"https://try.access.worldpay.com/verifications/accounts/{resource}\"\n },\n \"curies\": [{\n \"name\": \"verifications:verification\",\n \"href\": \"https://try.access.worldpay.com/rels/verifications/accounts/{rel}\",\n \"templated\": true\n }]\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Verified (cardOnFile)","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/verifications-response-verified-cof.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"outcome\": \"verified\",\n \"checkedAt\": \"2019-11-01T10:37:36.923Z\",\n \"schemeTransactionReference\": \"000000000000020005060720116005060\",\n \"riskFactors\": [{\n \"risk\": \"matched\",\n \"type\": \"cvc\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"postcode\",\n \"type\": \"avs\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"address\",\n \"type\": \"avs\"\n }\n ],\n \"_links\": {\n \"verifications:verification\": {\n \"href\": \"https://try.access.worldpay.com/verifications/accounts/{resource}\"\n },\n \"payments:cardonFileAuthorize\": {\n \"href\": \"https://try.access.worldpay.com/payments/authorizations/cardonFile/{resource}\"\n },\n \"payments:recurringAuthorize\": {\n \"href\": \"http://try.access.worldpay.com/payments/authorizations/recurring/{resource}\"\n },\n \"payments:recurringSale\": {\n \"href\": \"https://try.access.worldpay.com/payments/sales/recurring/{resource}\"\n },\n \"curies\": [{\n \"name\": \"verifications:verification\",\n \"href\": \"https://try.access.worldpay.com/rels/verifications/accounts/{rel}\",\n \"templated\": true\n }]\n }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Not verified (cardOnFile)","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/verifications-response-not-verified-cof.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n \"outcome\": \"not verified\",\n \"code\": \"106\",\n \"rawCode\": \"N7\",\n \"description\": \"INVALID ACCOUNT\",\n \"checkedAt\": \"2019-11-01T10:37:36.923Z\",\n \"riskFactors\": [{\n \"risk\": \"matched\",\n \"type\": \"cvc\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"postcode\",\n \"type\": \"avs\"\n },\n {\n \"risk\": \"matched\",\n \"detail\": \"address\",\n \"type\": \"avs\"\n }\n ],\n \"_links\": {\n \"verifications:verification\": {\n \"href\": \"https://try.access.worldpay.com/verifications/accounts/{resource}\"\n },\n \"curies\": [{\n \"name\": \"verifications:verification\",\n \"href\": \"https://try.access.worldpay.com/rels/verifications/accounts/{rel}\",\n \"templated\": true\n }]\n }\n}"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Verifications are accurate at the time of the initial request. Sending another ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#intelligent-verification"},"children":["intelligent"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#dynamic-verification"},"children":["dynamic"]}," verification request may return different results."]}]}]},"headings":[{"value":"Verify a customer's account","id":"verify-a-customers-account","depth":1},{"value":"Intelligent verification","id":"intelligent-verification","depth":2},{"value":"Intelligent verification request","id":"intelligent-verification-request","depth":3},{"value":"oneTime intelligent verification","id":"onetime-intelligent-verification","depth":3},{"value":"cardOnFile intelligent verification","id":"cardonfile-intelligent-verification","depth":3},{"value":"Example request body","id":"example-request-body","depth":3},{"value":"Dynamic verification","id":"dynamic-verification","depth":2},{"value":"Dynamic verification request","id":"dynamic-verification-request","depth":3},{"value":"dynamicOneTime verification","id":"dynamiconetime-verification","depth":3},{"value":"dynamicCardOnFile verification","id":"dynamiccardonfile-verification","depth":3},{"value":"Example request body","id":"example-request-body-1","depth":3},{"value":"3DS","id":"3ds","depth":2},{"value":"The descriptions of parameters from your 3DS authorization request","id":"the-descriptions-of-parameters-from-your-3ds-authorization-request","depth":4},{"value":"Apple Pay decrypted","id":"apple-pay-decrypted","depth":2},{"value":"Verification example request:","id":"verification-example-request","depth":4},{"value":"The descriptions of parameters from your Apple Pay decrypted authorization request","id":"the-descriptions-of-parameters-from-your-apple-pay-decrypted-authorization-request","depth":4},{"value":"Verifications response","id":"verifications-response","depth":2},{"value":"Risk Factors","id":"risk-factors","depth":4},{"value":"Payment Instrument","id":"payment-instrument","depth":4},{"value":"Location storing","id":"location-storing","depth":4},{"value":"Query a historic verification","id":"query-a-historic-verification","depth":2},{"value":"Query verifications request","id":"query-verifications-request","depth":3},{"value":"Query verifications response","id":"query-verifications-response","depth":3}],"frontmatter":{"seo":{"title":"Verify a customer's account"}},"lastModified":"2026-05-13T07:59:15.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/card-verifications/v4/verifications","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}