{"templateId":"markdown","versions":[{"version":"v5","label":"v5","link":"/products/card-payments/v5/v7-migration-guide","default":false,"active":false,"folderId":"5e391095"},{"version":"v6","label":"v6","link":"/products/card-payments/v6/v7-migration-guide","default":false,"active":false,"folderId":"5e391095"},{"version":"v7","label":"v7 (Latest)","link":"/products/card-payments/v7-migration-guide","default":true,"active":true,"folderId":"5e391095"}],"sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["partial"]},"custom_product":"Card Payments","type":"markdown"},"seo":{"title":"Card Payments version 7: migration guide","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"]},": 30 March 2026 | ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/changelog/"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Change log"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"card-payments-version-7-migration-guide","__idx":0},"children":["Card Payments version 7: migration guide"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page details the main changes between Card Payments version 6 and version 7. These are listed below with a subheading per API change."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"root-resource-naming","__idx":1},"children":["Root resource naming"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The API root resource has changed from \"payments\" to \"cardPayments\":"]},{"$$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":"Version 6"},"children":["Version 6"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Version 7"},"children":["Version 7"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/payments"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/cardPayments"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"headers","__idx":2},"children":["Headers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Headers have been updated as below:"]},{"$$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":"Header"},"children":["Header"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Version 6"},"children":["Version 6"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Version 7"},"children":["Version 7"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Accept"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/vnd.worldpay.payments-v6.hal+json"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"(was optional)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/vnd.worldpay.payments-v7+json"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"(now mandatory)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Content-Type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/vnd.worldpay.payments-v6+json"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["application/vnd.worldpay.payments-v7+json"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoints","__idx":3},"children":["Endpoints"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We have reduced the number of endpoints for authorization and sale from 8 to 2.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorize-a-payment"},"children":["version 6"]}," endpoint structure was split by:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Authorization / Sale"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["oneTime / cardOnFile / recurring"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/authorize-a-payment"},"children":["Version 7"]}," authorization endpoints are divided on whether the authorization is initiated by the customer, or by the merchant. This distinction affects much of what is possible or not possible in the request.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Some examples:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["CIT requests can include CVC; MIT cannot."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["CIT requests can include 3DS data; MIT cannot."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Encrypted Apple Pay / Google Pay ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}," types can be used with CIT; but not with MIT."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Network token payments require a cryptogram for CITs; but not for MITs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["MIT requests can have a scheme reference; CIT requests should not."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"version-6-endpoints","__idx":4},"children":["Version 6 endpoints"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorize-a-payment"},"children":["One time Authorize"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/payments/authorizations"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorise-a-cardonfile-payment"},"children":["Card on File Authorize"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/payments/authorizations/cardOnFile"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorise-a-cardonfile-payment"},"children":["Migrate Card on File Authorize"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/payments/authorizations/migrateCardOnFile/"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/migrate-cardonfile-sale"},"children":["Migrate Card on File Sale"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/payments/sales/migrateCardOnFile/"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorise-a-recurring-payment"},"children":["Recurring Authorize"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/payments/authorizations/recurring/{resource}"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorise-a-recurring-payment"},"children":["Migrate Recurring Authorize"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/payments/authorizations/migrateRecurring"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/take-a-sale"},"children":["Recurring Sale"]},": ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/payments/sales/recurring/{resource}"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"version-7-endpoints","__idx":5},"children":["Version 7 endpoints"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["CIT payments: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/cardPayments/customerInitiatedTransactions"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["MIT payments: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/cardPayments/merchantInitiatedTransactions"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"requesting-auto-settlement-authorization-vs-sale","__idx":6},"children":["Requesting auto settlement (authorization vs sale)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A new mandatory object, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"requestAutoSettlement\""]}," has been introduced to the request body to determine whether the request is sent for settlement or not:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"requestAutoSettlement\":{\n    \"enabled\": true / false\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," = we will send the authorization for settlement (this aligns with the \"sale\" endpoints in version 6)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}," = the payment will be sent for authorization only, and a next action link will be sent to you to request settlement (this aligns with the \"authorizations\" endpoints in version 6)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"customer-agreement-stored-credentials","__idx":7},"children":["Customer agreement (stored credentials)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Storing a card for later use is one of several agreements a customer might make for future processing at the time of payment. ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A new optional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"customerAgreement\""]}," object has been added to the request body for CIT authorizations (POST: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/cardPayments/customerInitiatedTransactions"]},"). If the authorization is not either using a stored credential for the first time, or for a subsequent usage, then the object should not be included in the request body.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is what we referred to as a \"one time\" authorization in version 6 of our API.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If, however, the CIT authorization is either the first use of a stored credential, or if the authorization is making use of a previously-stored credential, then the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"customerAgreement\""]}," object should be included:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cit-store-credential-for-future-cardonfile-processing","__idx":8},"children":["CIT: Store credential for future cardOnFile processing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Example use case:"]}," A customer is storing a card for the first time on their account on an ecom website, with the expectation that they will return to that website in future and don't want to type in their card details next time (ie, \"express checkout\")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["POST: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/cardPayments/customerInitiatedTransactions"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"customerAgreement\":{\n    \"type\":\"cardOnFile\",\n    \"storedCardUsage\":\"first\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cit-use-a-previously-stored-credential","__idx":9},"children":["CIT: Use a previously stored credential"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Example use case:"]}," A customer returns to a website where they have previously stored a card, and selects the saved card at checkout for a subsequent purchase."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["POST: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/cardPayments/customerInitiatedTransactions"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"customerAgreement\":{\n    \"type\":\"cardOnFile\",\n    \"storedCardUsage\":\"subsequent\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cit-store-a-card-for-future-subscription-payments","__idx":10},"children":["CIT: Store a card for future subscription payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example use case: A customer signs up to a subscription plan for the first time."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["POST: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/cardPayments/customerInitiatedTransactions"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"customerAgreement\":{\n    \"type\":\"subscription\",\n    \"storedCardUsage\":\"first\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"cit-store-a-card-for-future-installment-payments","__idx":11},"children":["CIT: Store a card for future installment payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example use case: A customer uses a Buy Now Pay Later service to buy a new laptop. The balance will be collected in monthly installments.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"installmentType\""]}," field distinguishes between the type of installment plan, eg where the merchant is the installment provider (BNPL use cases), or where a regional installment plan is being initiated (eg Latin America installments)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["POST: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/cardPayments/customerInitiatedTransactions"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"customerAgreement\":{\n    \"type\":\"installment\",\n    \"installmentType\":\"merchant\",\n    \"storedCardUsage\":\"first\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"mit-take-a-subscription-payment","__idx":12},"children":["MIT: Take a subscription payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example use case: A merchant collects a payment for a previously-agreed subscription plan."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["POST: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/cardPayments/merchantInitiatedTransactions"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"customerAgreement\":{\n    \"type\":\"subscription\",\n    \"schemeReference\":\"MCCOLXT1C0104\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"mit-take-a-merchant-installment-payment","__idx":13},"children":["MIT: Take a merchant installment payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example use case: A merchant collects a payment for a previously-agreed BNPL installment plan."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["POST: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["access.worldpay.com/cardPayments/merchantInitiatedTransactions"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"customerAgreement\":{\n    \"type\":\"installment\",\n    \"installmentType\":\"merchant\",\n    \"schemeReference\":\"MCCOLXT1C0104\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"sending-3ds-data-for-network-tokens","__idx":14},"children":["Sending 3DS data for Network Tokens"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["3DS and Network Token authentication have moved out of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"customer\".\"authentication\""]}," object, and an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"authentication\""]}," object now lives at the top level of the JSON schema. The authentication ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"types\""]}," are now explicitly-named objects: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"threeDS\""]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"networkToken\""]},". This allows both the cryptogram for network tokens and 3DS data to be sent in the same request:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["3DS and Network Token in the same request (v7):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"authentication\":{\n    \"threeDS\":{\n        \"version\":\"2.1.0\",\n        \"eci\":\"05\",\n    \"authenticationValue\":\"MAAAAAAAAAAAAAAAAAAAAAAAAAA=\",\n        \"transactionId\":\"c5b808e7-1de1-4069-a17b-f70d3b3b1645\"\n        },\n    \"networkToken\":{\n        \"cryptogram\":\"MAAAAAAAAAAAAAAAAAAAAAAAAAB=\",\n        \"eci\":\"05\"\n    }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In version 6, ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["either"]}," the network token cryptogram or 3DS authentication data could be sent, depending on the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"type\""]}," selected:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Network token (v6):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"customer\": {\n    \"authentication\": {\n        \"type\": \"card/networkToken\",\n        \"authenticationValue\": \"abc123==\"\n    }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["3DS (v6):"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"\"customer\": {\n    \"authentication\": {\n        \"version\": \"2.2.0\",\n        \"type\": \"3DS\",\n        \"eci\": \"05\",\n        \"authenticationValue\": \"MTIzNDU2Nzg5MDEyMzQ1Njc4OTA=\",\n        \"transactionId\": \"c5b808e7-1de1-4069-a17b-f70d3b3b1645\"\n    }\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"risk-profile-placement","__idx":15},"children":["Risk profile placement"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Since ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"authentication\""]}," is no longer housed within the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"customer\""]}," object, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"riskProfile\""]}," has also been moved to top level in the JSON schema. No other changes have been made to this field."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"request-field-name-changes","__idx":16},"children":["Request field name changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Several field name changes have been made, but no breaking validations have been made:"]},{"$$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":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Version 6"},"children":["Version 6"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Version"},"children":["Version"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Facilitator ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.pfId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.schemeId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Facilitator ISO ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.isoId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.independentSalesOrganizationId"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Facilitator Tax ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.taxId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.taxReference"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Facilitator Address"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.subMerchant.street"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.subMerchant.city"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.subMerchant.postalCode"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.subMerchant.countryCode"]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Submerchant address fields moved within an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["address"]}," object: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.subMerchant.address.street"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.subMerchant.address.city"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.subMerchant.address.postalCode"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.subMerchant.address.countryCode"]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DPAN (network token and Apple Pay Decrypted)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.paymentInstrument.dpan"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.paymentInstrument.tokenNumber"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Instrument expiry date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.paymentInstrument.cardExpiryDate"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.paymentInstrument.expiryDate"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Network Token cryptogram"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customer.authentication.authenticationValue"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["authentication.networkToken.cryptogram"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"currency-exponent-changes","__idx":17},"children":["Currency exponent changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The exponent for the following currencies exponents have changed CLP, CVE, ISK, UGX"]},{"$$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":"Currency"},"children":["Currency"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Old exponent"},"children":["Old exponent"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"New exponent"},"children":["New exponent"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CLP"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CVE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISK"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UGX"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["0"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"response-field-name-changes","__idx":18},"children":["Response field name changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Several field name changes have been made, but no breaking validations have been made:"]},{"$$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":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Version 6"},"children":["Version 6"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Version"},"children":["Version"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$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.risk"]}," values"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_checked"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_matched"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not_supplied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notChecked"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notMatched"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notSupplied"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Casing changed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card BIN"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.number.bin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardBin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"card\""]}," dropped from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card Last Four Digits"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.number.last4Digits"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["lastFour"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"card\""]}," dropped from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card Brand"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.brand"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["brand"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"card\""]}," dropped from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card Funding Type (credit, debit, pre-paid, etc)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.fundingType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fundingType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"card\""]}," dropped from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card Category (commercial, consumer)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.category"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["category"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"card\""]}," dropped from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payment Account Reference (PAR)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card.paymentAccountReference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentAccountReference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"card\""]}," dropped from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card issuer name has been flattened"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.card.issuer.name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.issuerName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"card\""]}," dropped from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refusal code renamed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refusalCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remains at top level"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refusal description renamed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refusalDescription"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remains at top level"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Refusal advice code (MAC)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refusalAdvice.code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["advice.code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Renamed because Mastercard can now return MAC for approvals"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Raw code has been removed. We now map the normalized extended decline code or the raw code to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refusalCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rawCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refusalCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This will now depend on whether the merchant code is enabled for raw codes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"_links\""]}," namespacing updated"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eg ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"payments:refund\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eg ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"cardPayments:refund\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"changes-to-error-responses","__idx":19},"children":["Changes to error responses"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"json-path-errors","__idx":20},"children":["JSON path errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["jsonPath"]}," value for validation failures on JSON paths have been updated."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Version 6:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n\"errorName\": \"bodyDoesNotMatchSchema\",\n\"message\": \"The json body provided does not match the expected schema\",\n\"validationErrors\": [\n {\n    \"errorName\": \"fieldIsMissing\",\n    \"message\": \"Element at path must be supplied\",\n    \"jsonPath\": \"/instruction/value\"\n    }\n    ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Version 7:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n\"errorName\": \"bodyDoesNotMatchSchema\",\n\"message\": \"The json body provided does not match the expected schema\",\n\"validationErrors\": [\n    {\n    \"errorName\": \"fieldIsMissing\",\n    \"message\": \"Element at path must be supplied\",\n    \"jsonPath\": \"$.instruction.value\"\n    }\n    ]\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"unexpected-response-from-downstream","__idx":21},"children":["Unexpected response from downstream"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Unexpected responses from downstream systems now return a JSON object, rather than a string:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Version 6:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"Unexpected response from downstream\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Version 7:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n    \"errorName\": \"internalErrorOccurred\",\n    \"message\": \"Unexpected response from downstream\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"an-country-code-no-longer-supported","__idx":22},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AN"]}," country code no longer supported"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Country Code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AN"]}," is no longer supported in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentFacilitator.subMerchant.address.countryCode"]},"."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]}]},"headings":[{"value":"Card Payments version 7: migration guide","id":"card-payments-version-7-migration-guide","depth":1},{"value":"Root resource naming","id":"root-resource-naming","depth":2},{"value":"Headers","id":"headers","depth":2},{"value":"Endpoints","id":"endpoints","depth":2},{"value":"Version 6 endpoints","id":"version-6-endpoints","depth":3},{"value":"Version 7 endpoints","id":"version-7-endpoints","depth":3},{"value":"Requesting auto settlement (authorization vs sale)","id":"requesting-auto-settlement-authorization-vs-sale","depth":2},{"value":"Customer agreement (stored credentials)","id":"customer-agreement-stored-credentials","depth":2},{"value":"CIT: Store credential for future cardOnFile processing","id":"cit-store-credential-for-future-cardonfile-processing","depth":3},{"value":"CIT: Use a previously stored credential","id":"cit-use-a-previously-stored-credential","depth":3},{"value":"CIT: Store a card for future subscription payments","id":"cit-store-a-card-for-future-subscription-payments","depth":3},{"value":"CIT: Store a card for future installment payments","id":"cit-store-a-card-for-future-installment-payments","depth":3},{"value":"MIT: Take a subscription payment","id":"mit-take-a-subscription-payment","depth":3},{"value":"MIT: Take a merchant installment payment","id":"mit-take-a-merchant-installment-payment","depth":3},{"value":"Sending 3DS data for Network Tokens","id":"sending-3ds-data-for-network-tokens","depth":3},{"value":"Risk profile placement","id":"risk-profile-placement","depth":3},{"value":"Request field name changes","id":"request-field-name-changes","depth":3},{"value":"Currency exponent changes","id":"currency-exponent-changes","depth":3},{"value":"Response field name changes","id":"response-field-name-changes","depth":3},{"value":"Changes to error responses","id":"changes-to-error-responses","depth":3},{"value":"JSON path errors","id":"json-path-errors","depth":4},{"value":"Unexpected response from downstream","id":"unexpected-response-from-downstream","depth":4},{"value":"AN country code no longer supported","id":"an-country-code-no-longer-supported","depth":4}],"frontmatter":{"seo":{"title":"Card Payments version 7: migration guide"}},"lastModified":"2025-09-22T09:15:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/card-payments/v7-migration-guide","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}