{"templateId":"markdown","versions":[{"version":"v5","label":"v5","link":"/products/card-payments/v5/repeat-payments","default":false,"active":false,"folderId":"5e391095"},{"version":"v6","label":"v6","link":"/products/card-payments/v6/repeat-payments","default":false,"active":false,"folderId":"5e391095"},{"version":"v7","label":"v7 (Latest)","link":"/products/card-payments/repeat-payments","default":true,"active":true,"folderId":"5e391095"}],"sharedDataIds":{"sidebar":"sidebar-products/card-payments/sidebars.yaml","current-catalog-info":"current-catalog-info-/products/card-payments/openapi"},"props":{"metadata":{"markdoc":{"tagList":["partial","admonition","tabs","tab","code-snippet","json-schema","cards","card"]},"custom_product":"Card Payments","type":"markdown"},"seo":{"title":"Take repeat card payments","description":"Worldpay for Developers - docs, code examples, resources and tools. Everything you need to build your omnichannel payment solution.","siteUrl":"https://docs.worldpay.com/access","image":"/access/assets/worldpay-logo-light.21b7daf79984773a9fcd7d4fbcb07ae5289dfffd6023c4c3dca720c7058e53dc.33f780a6.svg","keywords":"documentation, api, openapi, sdks, developer, payments, json, payouts, 3ds","jsonLd":{"@context":"https://schema.org","@type":"Organization","url":"https://docs.worldpay.com/access","name":"Worldpay"},"meta":[{"name":"google-site-verification","content":"zjziIKaP3ImsqsfhYnEBnq1R85UabiSwl7HTXuwtZuo"},{"name":"doc_product","content":"Access"},{"name":"doc_category","content":"Documentation"}],"llmstxt":{"hide":false,"sections":[{"title":"Payments API","description":"Payment orchestration API combining fraud assessment, 3ds authentication, SCA exemptions, Worldpay Token creation and a card or wallet based payment.","includeFiles":["products/payments/@20240601/**/*"],"excludeFiles":[]},{"title":"Payment Queries API","description":"Querying your payments data, based on a variety of parameters.","includeFiles":["products/payment-queries/@v1/**/*"],"excludeFiles":[]},{"title":"Card BIN Data API","description":"Provides detailed information about a card.","includeFiles":["products/card-bin/@v1/**/*"],"excludeFiles":[]},{"title":"3DS Authentication API","description":"Request 3DS authentication to protect against fraud, be SCA compliant and to shift liability using this standalone API.","includeFiles":["products/3ds/@v3/**/*"],"excludeFiles":[]},{"title":"FraudSight API","description":"Request a risk assessment and receive a response with an outcome (e.g. lowRisk) using this standalone API.","includeFiles":["products/fraudsight/@v1/**/*"],"excludeFiles":[]},{"title":"Checkout SDK","description":"Integrate using our clientside SDKs for both web and native devices. Benefit from SAQ-A/PCI-SSF compliance.","includeFiles":["products/checkout/web/@v2/**/*","products/checkout/ios/@v4/**/*","products/checkout/android/@v4/**/*","products/checkout/react-native/@v3/**/*","products/checkout/flutter/@v1/**/*"],"excludeFiles":[]},{"title":"Tokens API","description":"Minimizes the exposure of sensitive card details and increases the security of your customer's card details.","includeFiles":["products/tokens/@v3/**/*"],"excludeFiles":[]},{"title":"Card Payments API","description":"Request a card payment using this standalone API, requires separate requests for 3DS, Fraud assessment etc.","includeFiles":["products/card-payments/@v7/**/*"],"excludeFiles":[]},{"title":"Card Verifications API","description":"Verify your customer's card to maximize your authentication rates.","includeFiles":["products/card-verifications/@v6/**/*"],"excludeFiles":[]},{"title":"Account Payouts API","description":"Send funds to your customer's bank accounts and search for payouts using parameters.","includeFiles":["products/account-payouts/@20250101/**/*"],"excludeFiles":[]},{"title":"APMs","description":"Pay using eWallets, bank transfers, direct debits, local card schemes, Postpay and eInvoice/ Buy Now Pay Later.","includeFiles":["products/apms/@20240701/**/*"],"excludeFiles":[]},{"title":"Balance API","description":"Request your account details for a single account or all accounts under an entity.","includeFiles":["products/balance/@20250101/**/*"],"excludeFiles":[]},{"title":"Card Payouts API","description":"Send funds to your customer's cards.","includeFiles":["products/card-payouts/@v4/**/*"],"excludeFiles":[]},{"title":"Events (Webhooks)","description":"Receive status updates from Access Worldpay by setting up a webhook.","includeFiles":["products/events/@v1/**/*"],"excludeFiles":[]},{"title":"FX API","description":"Manage Foreign Exchange (FX) on your payments.","includeFiles":["products/fx/@v1/**/*"],"excludeFiles":[]},{"title":"Hosted Payment Pages (HPP) API","description":"Our low-code option to take payments securely at the lowest PCI compliance level - SAQ A.","includeFiles":["products/hosted-payment-pages/@v1/**/*"],"excludeFiles":[]},{"title":"Money Transfers API","description":"Money Transfer OCTs (Original Credit Transaction) allow funds to be pushed to an eligible card in 30 minutes or less.","includeFiles":["products/money-transfers/@v1/**/*"],"excludeFiles":[]},{"title":"Parties API","description":"Create parties, manage your payout instruments and beneficial owners and carry out identity verification checks.","includeFiles":["products/parties/@20250101/**/*"],"excludeFiles":[]},{"title":"SCA Exemptions API","description":"Maximize a frictionless checkout experience by using issuer data insights to apply exemptions.","includeFiles":["products/sca-exemptions/@v1/**/*"],"excludeFiles":[]},{"title":"Split Payments API","description":"Divide funds from a single payment amongst yourself and your parties/sellers.","includeFiles":["products/split-payments/@20250625/**/*"],"excludeFiles":[]},{"title":"Statements API","description":"Retrieve your account statement and see individual entries for all credits and debits.","includeFiles":["products/statements/@20250101/**/*"],"excludeFiles":[]},{"title":"Transfers API","description":"Transfer funds from source account to target account.","includeFiles":["products/transfers/@20250101/**/*"],"excludeFiles":[]},{"title":"Verified Tokens API","description":"Verified Tokens ensures that your customer's payment details are valid and CIT compliant when creating a token.","includeFiles":["products/verified-tokens/@v3/**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Last updated"]},": 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":"take-repeat-card-payments","__idx":0},"children":["Take repeat card payments"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"New API version"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This documentation is for version 7 of the Card Payments API. If you're using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorize-a-payment"},"children":["version 6"]},", you can find information on how to upgrade in our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v7-migration-guide"},"children":["migration guide"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Take repeat card payments using our Card Payments API."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"merchant-initiated-transactions","__idx":1},"children":["Merchant Initiated Transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can take payments without the active participation of the customer according to an agreement previously made with the cardholder. These are known as Merchant Initiated Transactions (MITs)."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," to our ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantInitiatedTransactions"]}," endpoint to authorize a payment."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The requests below contain all the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["mandatory"]}," fields needed for a successful authorization 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/cardPayments/merchantInitiatedTransactions"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click the tabs below to see all the mandatory fields for all supported ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}," parameters."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Merchant Initiated Transaction request body:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Card","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/mit/requests/mit-request-card.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"requestAutoSettlement\": {\n            \"enabled\": false\n        },\n        \"narrative\": {\n            \"line1\": \"Mind Palace\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 250\n        },\n        \"paymentInstrument\": {\n            \"type\": \"card/plain\",\n            \"cardNumber\": \"4444333322221111\",\n            \"expiryDate\": {\n                \"month\": 5,\n                \"year\": 2035\n            }\n        },\n        \"customerAgreement\": {\n            \"type\": \"subscription\",\n            \"schemeReference\": \"000000000000020005060720116005061\"\n        }\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/mit/requests/mit-request-token.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"requestAutoSettlement\": {\n            \"enabled\": false\n        },\n        \"narrative\": {\n            \"line1\": \"Mind Palace\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 250\n        },\n        \"paymentInstrument\": {\n            \"type\": \"card/token\",\n            \"href\": \"https://try.access.worldpay.com/tokens/{}\"\n        },\n        \"customerAgreement\": {\n            \"type\": \"subscription\",\n            \"schemeReference\": \"000000000000020005060720116005061\"\n        }\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Network token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/mit/requests/mit-request-networkToken.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"requestAutoSettlement\": {\n            \"enabled\": false\n        },\n        \"narrative\": {\n            \"line1\": \"Mind Palace\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 250\n        },\n        \"paymentInstrument\": {\n            \"type\": \"card/networkToken\",\n            \"tokenNumber\": \"4444333322221111\",\n            \"expiryDate\": {\n                \"month\": 5,\n                \"year\": 2035\n            }\n        },\n        \"customerAgreement\": {\n            \"type\": \"subscription\",\n            \"schemeReference\": \"000000000000020005060720116005061\"\n        }\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Apple Pay decrypted","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/mit/requests/mit-request-apple-pay-decrypted.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"requestAutoSettlement\": {\n            \"enabled\": false\n        },\n        \"narrative\": {\n            \"line1\": \"Mind Palace\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 250\n        },\n        \"paymentInstrument\": {\n            \"type\": \"card/networkToken+applepay\",\n            \"tokenNumber\": \"4444333322221111\",\n            \"expiryDate\": {\n                \"month\": 5,\n                \"year\": 2035\n            }\n        },\n        \"customerAgreement\": {\n            \"type\": \"subscription\",\n            \"schemeReference\": \"000000000000020005060720116005061\"\n        }\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Google Pay decrypted","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/mit/requests/mit-request-google-pay-decrypted.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"requestAutoSettlement\": {\n            \"enabled\": false\n        },\n        \"narrative\": {\n            \"line1\": \"Mind Palace\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 650\n        },\n        \"paymentInstrument\": {\n            \"type\": \"card/networkToken+googlepay\",\n            \"tokenNumber\": \"4444333322221111\",\n            \"expiryDate\": {\n                \"month\": 5,\n                \"year\": 2035\n            }\n        },\n        \"customerAgreement\": {\n            \"type\": \"subscription\",\n            \"schemeReference\": \"123456789\"\n        }\n    }\n}"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Important"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before taking a Merchant Initiated Transaction, you must obtain prior agreement with the cardholder to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/authorize-a-payment#store-a-card"},"children":["store a card"]},"."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use mobile wallets to process Merchant Initiated Transactions either:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["by decrypting them yourself, or"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["by using the wallet payload that was converted into a Worldpay Token during the initial Customer Initiated Transaction"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"schema-parameters","__idx":2},"children":["Schema (parameters)"]},{"$$mdtype":"Tag","name":"JsonSchema","attributes":{"schema":{"$ref":"openapi.yaml#/components/schemas/merchantInitiatedTransaction"},"options":{"schemaExpansionLevel":0},"schemaResolved":{"openapi":"3.1.0","components":{"schemas":{"__root":{"$ref":"#/components/schemas/merchantInitiatedTransaction"},"transactionReference":{"maxLength":64,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"A unique reference generated by you that is used to identify a payment throughout its lifecycle."},"orderReference":{"type":"string","description":"A reference that you can apply to one or more payments according to your business needs. You may reuse the same reference across multiple payments, for example where:\n- the total amount for a single order is split across multiple payments\n- you use a single reference for each payment in a recurring agreement or split shipment scenario","maxLength":64,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~/+]*$","example":"order-12345"},"entity":{"maxLength":32,"minLength":1,"pattern":"^([A-Za-z0-9]+[A-Za-z0-9 ]*)?$","example":"default","type":"string","description":"An identifier we provide during onboarding. Some merchants may have more than one `entity`. Direct your payment accordingly to assist with billing, reporting and reconciliation. This is mandatory for authentication and queries."},"mcc":{"pattern":"^\\d{4}$","type":"string","description":"You can apply a merchant category code `mcc` to an individual request. You can only provide an `mcc` if we have enabled the dynamic mcc feature during boarding. If enabled but not provided, `merchant.mcc` defaults to a configured value.","maxLength":4,"minLength":4},"paymentFacilitator":{"required":["schemeId","subMerchant"],"type":"object","description":"An object containing Payment Facilitator information. This information is required for every authorization **only if you are a Payment Facilitator**.","properties":{"schemeId":{"maxLength":11,"minLength":1,"pattern":"[0-9]*$","type":"string","description":"Your payment facilitator ID received from Visa, Mastercard, or Amex."},"independentSalesOrganizationId":{"maxLength":11,"minLength":1,"pattern":"[0-9]*$","type":"string"},"subMerchant":{"required":["reference","name","address"],"type":"object","properties":{"name":{"maxLength":25,"minLength":1,"pattern":"^(?!\\s*$)[A-Za-z0-9 ]*$","type":"string"},"reference":{"type":"string","minLength":1,"maxLength":15,"pattern":"^[A-Za-z0-9]*$"},"address":{"type":"object","required":["postalCode","street","city","countryCode"],"properties":{"postalCode":{"maxLength":10,"minLength":1,"pattern":"^(?!\\s*$)[a-zA-Z0-9\\s]*$","type":"string","example":"SW1 1AA"},"street":{"maxLength":50,"minLength":1,"pattern":"^(?!\\s*$)[A-Za-z0-9\\s]*$","type":"string","example":"221B Baker Street"},"city":{"maxLength":13,"minLength":1,"pattern":"^(?!\\s*$)[A-Za-z\\s-]*$","type":"string","example":"London"},"state":{"maxLength":3,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"The state code of the subMerchant in ISO-3166-2 format."},"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string","description":"Country code of the subMerchant in [ISO 3166-1 Alpha-2 format](/products/reference/supported-countries-currencies#iso-country-codes)."}}},"phoneNumber":{"maxLength":20,"minLength":4,"pattern":"^(?!\\s*$)[0-9\\s()+-/.x]*$","type":"string"},"taxReference":{"maxLength":20,"minLength":1,"pattern":"^(?!\\s*$)[a-zA-Z0-9\\s-]*$","type":"string"},"email":{"maxLength":40,"minLength":1,"type":"string","pattern":"^.+@.+$"},"url":{"maxLength":255,"minLength":1,"pattern":"^[a-zA-Z0-9@!£*#$)(+-_=.,/;:]*$","type":"string"}}}}},"taxReference":{"maxLength":20,"minLength":1,"pattern":"^(?!\\s*$)[a-zA-Z0-9\\s-]*$","type":"string","description":"Merchant's tax reference."},"value":{"required":["amount","currency"],"type":"object","description":"An object that contains information about the value of the payment.","properties":{"amount":{"type":"integer","description":"The payment amount. This is a whole number with an exponent e.g. if exponent is two, 250 is 2.50.","example":250},"currency":{"type":"string","minLength":3,"maxLength":3,"pattern":"^[A-Z]$","description":" The three character currency code. See list of [supported currencies](/products/reference/supported-countries-currencies#iso-currency-codes).","example":"USD"}}},"narrative":{"required":["line1"],"type":"object","description":"The text that appears on your customer's statement. Used to identify the merchant.","properties":{"line1":{"type":"string","minLength":1,"maxLength":24,"pattern":"^[a-zA-Z0-9 _!@#$%()*=.:;?[]{}~/+-,`^&]*$","description":"The first line of the narrative which appears on your customer's statement (24 characters max. If character is not supported it is replaced with a space)."},"line2":{"type":"string","minLength":1,"maxLength":24,"pattern":"^[a-zA-Z0-9 _!@#$%()*=.:;?[]{}~/+-,`^&]*$","description":"Additional details about the payment e.g. order number, telephone number."}}},"cardNumber":{"type":"string","maxLength":19,"minLength":12,"pattern":"^[0-9]+$","description":"Your customer's card number. Sometimes referred to as Primary Account Number (PAN)."},"cardHolderName":{"type":"string","minLength":1,"maxLength":255,"description":"The cardholder's name as it appears on their card."},"expiryDateCard":{"required":["month","year"],"type":"object","description":"Contains your customer's card expiry date.","properties":{"month":{"type":"integer","pattern":"^([1-9]|1[0-2])$","example":7},"year":{"type":"integer","pattern":"^([1-9]{1}[0-9]{3})$","example":2050}}},"billingAddress":{"required":["postalCode","countryCode"],"type":"object","description":"Contains the billing address information.","properties":{"address1":{"type":"string","description":"First line of the address. Required if `city` is provided."},"address2":{"type":"string","description":"Second line of the address."},"address3":{"type":"string","description":"Third line of the address."},"city":{"type":"string","description":"City. Required if `address1` is provided."},"postalCode":{"type":"string","description":"Post code. Required, but an empty value can be provided for specific countries (e.g., `IE`)."},"state":{"type":"string","description":"State/province in max 3 characters."},"countryCode":{"type":"string","description":"Must be provided in [ISO 3166-1 Alpha-2 format](/products/reference/supported-countries-currencies#iso-country-codes)."},"phoneNumber":{"type":"string","description":"Phone number.","minLength":3,"maxLength":20,"pattern":"^[0-9()+-/.x ]+$"}}},"card_plain_mit":{"required":["type","cardNumber","expiryDate"],"type":"object","properties":{"type":{"enum":["card/plain"],"type":"string","description":"An identifier for the `paymentInstrument` being used."},"cardNumber":{"$ref":"#/components/schemas/cardNumber"},"cardHolderName":{"$ref":"#/components/schemas/cardHolderName"},"expiryDate":{"$ref":"#/components/schemas/expiryDateCard"},"billingAddress":{"$ref":"#/components/schemas/billingAddress"}}},"card_token_mit":{"required":["type","href"],"type":"object","properties":{"type":{"enum":["card/token"],"type":"string","description":"An identifier for the `paymentInstrument` being used."},"href":{"type":"string","description":"An `http` address that contains your link to an Access Token."}}},"tokenNumber":{"type":"string","maxLength":19,"minLength":12,"pattern":"^[0-9]+$","description":"The network token number."},"expiryDateToken":{"required":["month","year"],"type":"object","description":"Contains your customer's token expiry date.","properties":{"month":{"type":"integer","pattern":"^([1-9]|1[0-2])$","example":7},"year":{"type":"integer","pattern":"^([1-9]{1}[0-9]{3})$","example":2050}}},"fpanLastFour":{"type":"string","maxLength":4,"minLength":4,"pattern":"^[0-9]+$","description":"{% admonition type=\"warning\" name=\"Coming soon\" %}Preview only. Not yet available in production.{% /admonition %}\nThe last four digits of the actual card number, commonly referred to as the Funding Primary Account Number (FPAN). For [mobile wallet transactions](/products/wallets#card-metadata), the mobile wallet provider (e.g. Apple or Google) returns this to you, where supported by the issuer. For network tokens, retrieve this from your token provider."},"card_networkToken":{"required":["type","tokenNumber","expiryDate"],"type":"object","properties":{"type":{"enum":["card/networkToken"],"type":"string","description":"An identifier for the `paymentInstrument` being used."},"tokenNumber":{"$ref":"#/components/schemas/tokenNumber"},"expiryDate":{"$ref":"#/components/schemas/expiryDateToken"},"billingAddress":{"$ref":"#/components/schemas/billingAddress"},"cardHolderName":{"$ref":"#/components/schemas/cardHolderName"},"fpanLastFour":{"$ref":"#/components/schemas/fpanLastFour"}}},"card_networkToken_applepay":{"required":["type","tokenNumber","expiryDate"],"type":"object","properties":{"type":{"enum":["card/networkToken+applepay"],"type":"string"},"tokenNumber":{"$ref":"#/components/schemas/tokenNumber"},"expiryDate":{"$ref":"#/components/schemas/expiryDateToken"},"billingAddress":{"$ref":"#/components/schemas/billingAddress"},"cardHolderName":{"$ref":"#/components/schemas/cardHolderName"},"fpanLastFour":{"$ref":"#/components/schemas/fpanLastFour"}}},"card_networkToken_googlepay":{"required":["type","tokenNumber","expiryDate"],"type":"object","properties":{"type":{"enum":["card/networkToken+googlepay"],"type":"string"},"tokenNumber":{"$ref":"#/components/schemas/tokenNumber"},"expiryDate":{"$ref":"#/components/schemas/expiryDateToken"},"billingAddress":{"$ref":"#/components/schemas/billingAddress"},"cardHolderName":{"$ref":"#/components/schemas/cardHolderName"},"fpanLastFour":{"$ref":"#/components/schemas/fpanLastFour"}}},"responseSchemeReference":{"type":"string","minLength":1,"maxLength":255,"description":"Used by the card scheme to link merchant initiated transactions (MITs) to the original customer initiated transaction (CIT). Supply the value returned by the card scheme in the original CIT.","example":"446238472410421"},"responseSupplementaryReference":{"type":"string","minLength":1,"maxLength":255,"description":"{% admonition type=\"warning\" name=\"Coming soon\" %}Preview only. Not yet available in production.{% /admonition %}\nApplies to Mastercard transactions only. A secondary reference used by the card scheme to link merchant initiated transactions (MITs) to the original customer initiated transaction (CIT). Supply the value returned by the card scheme in the original CIT.\n\nPlease see our [Mastercard TLID guide](/products/card-payments/features/mastercard-tlid) for more details.","example":"MCCOLXT1C0104  "},"mit_subscription":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer. A subscription plan occurs at fixed time intervals."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"supplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"}}},"mit_installment":{"required":["type","installmentType"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"supplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"},"installmentType":{"type":"string","description":"Defines the type of installments service.","enum":["merchant"]}}},"mit_unscheduled":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"supplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"}}},"mit_reauthorization":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"supplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"},"storedCardUsage":{"type":"string","description":"Set to `subsequent` if the transaction is using a stored card.","enum":["subsequent"]}}},"mit_resubmission":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"supplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"},"storedCardUsage":{"type":"string","description":"Set to `subsequent` if the transaction is using a stored card.","enum":["subsequent"]}}},"mit_noShow":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"supplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"},"storedCardUsage":{"type":"string","description":"Set to `subsequent` if the transaction is using a stored card.","enum":["subsequent"]}}},"mit_delayedCharge":{"required":["type"],"properties":{"type":{"type":"string","description":"The processing arrangement agreed with your customer."},"schemeReference":{"$ref":"#/components/schemas/responseSchemeReference"},"supplementaryReference":{"$ref":"#/components/schemas/responseSupplementaryReference"},"storedCardUsage":{"type":"string","description":"Set to `subsequent` if the transaction is using a stored card.","enum":["subsequent"]}}},"consumerBillPayment":{"type":"boolean","description":"Consumer Bill Payment is a flag which identifies a bill payment paid by providers on behalf of consumers."},"requestAccountUpdater":{"type":"boolean","description":"Allows you to request a real-time account update when using a previously stored card. You can only use this with `customerAgreement` transactions with a `storedCardUsage` value of `subsequent`. If the stored card details that you provided for the transaction are no longer valid and new credentials are available, the authorization will be processed with the new card and its details will be returned in the `updatedPaymentInstrument` object in the response."},"debtRepayment":{"type":"boolean","description":"Debt Repayment Indicator is a flag which identifies a payment with the purpose of repaying a debt."},"fundsTransfer_bankAccount":{"type":"object","properties":{"type":{"enum":["bankAccount"],"type":"string"},"identifierType":{"type":"string","enum":["iban","swift","routingNumber","accountNumber"]},"iban":{"maxLength":34,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"The International Bank Account Number (IBAN) of the recipient. Required if `identifierType` is `iban`.","example":"IE12BOFI90000112345678"},"accountNumber":{"maxLength":39,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"The account number of the recipient. Required if `identifierType` is `routingNumber`, `swift` or `accountNumber`. Visa requires the value to be a maximum of 34 characters. ","example":"01234567"},"swiftBic":{"maxLength":11,"minLength":8,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"The SWIFT Bank Identification Code (BIC) of the recipient. Required if `identifierType` is `swift`. Must be either 8 or 11 alphanumeric characters.","example":"BEASUS33xxx"},"routingNumber":{"maxLength":9,"minLength":9,"pattern":"^[0-9]*$","type":"string","description":"The ABA (American Bankers Association) Routing Transit Number (RTN). Identifies the Financial Insititution of the recipient's account. Required if `identifierType` is `routingNumber`. Must be 9 numeric characters.","example":"111000025"}},"required":["type","identifierType"]},"fundsTransfer_card":{"type":"object","properties":{"type":{"enum":["card"],"type":"string"},"cardNumber":{"maxLength":19,"minLength":12,"pattern":"^[0-9]*$","type":"string","description":"Recipient's card number."}},"required":["type","cardNumber"]},"fundsTransfer_wallet":{"type":"object","properties":{"type":{"enum":["wallet"],"type":"string"},"walletReference":{"maxLength":50,"minLength":1,"pattern":"^[A-Za-z0-9@!£$*#)(+\\-_=.,/:;\"]*$","type":"string","description":"A reference identifying the destination wallet. Visa requires the value to be a maximum of 34 characters."}},"required":["type","walletReference"]},"fundsTransfer_storedValueWallet":{"type":"object","properties":{"type":{"enum":["storedValueWallet"],"type":"string"},"walletReference":{"maxLength":50,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"A reference identifying the destination wallet. Visa requires the value to be a maximum of 34 characters."}},"required":["type","walletReference"]},"fundsTransfer_stagedDigitalWallet":{"type":"object","properties":{"type":{"enum":["stagedDigitalWallet"],"type":"string"},"walletReference":{"maxLength":50,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"A reference identifying the destination wallet. Visa requires the value to be a maximum of 34 characters."}},"required":["type","walletReference"]},"fundsTransfer_merchantWallet":{"type":"object","properties":{"type":{"enum":["merchantWallet"],"type":"string"},"walletReference":{"maxLength":50,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"A reference identifying the destination wallet. Visa requires the value to be a maximum of 34 characters."}},"required":["type","walletReference"]},"fundsTransfer_email":{"type":"object","properties":{"type":{"enum":["email"],"type":"string"},"emailAddress":{"maxLength":40,"minLength":1,"type":"string","description":"Recipient's email address. Visa requires the value to be a maximum of 34 characters."}},"required":["type","emailAddress"]},"fundsTransfer_phone":{"type":"object","properties":{"type":{"enum":["phone"],"type":"string"},"phoneNumber":{"maxLength":20,"minLength":3,"type":"string","description":"Recipient's phone number.","pattern":"^[0-9 ()+\\-/.x]+$"}},"required":["type","phoneNumber"]},"fundsTransfer_socialNetwork":{"type":"object","properties":{"type":{"enum":["socialNetwork"],"type":"string"},"socialNetworkReference":{"maxLength":50,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"A reference identifying recipient's social network account. Visa requires the value to be a maximum of 34 characters."}},"required":["type","socialNetworkReference"]},"fundsTransfer":{"type":"object","description":"Contains details of the funds transfer request, which is a money movement for a reason other than the purchase of goods or services (also known as Account Funding Transaction (AFT)).","required":["type"],"properties":{"type":{"description":"Specifies the type of the funds transfer. {% admonition type=\"warning\" name=\"Note\" %} You may only submit the `fundsTransfer.type` values that relate to the use cases that you have been approved for by the schemes.{% /admonition %}","enum":["accountToAccount","cash","disbursement","personToPerson","purchase","topUp","walletLoad"],"type":"string","x-enumDescriptions":{"accountToAccount":"Move funds to another financial institution account owned by the same person","cash":"A card is used to fund a transfer where funds are given to the recipient in cash","disbursement":"A card is used as the source of funds for a disbursement","personToPerson":"Move funds to an account owned by another person (eg gifts)","purchase":"For the initial purchase of a reloadable account (such as prepaid or gift card), or direct crypto and liquid asset purchases without an intermediary wallet load","topUp":"Top up a pre-paid or debit card","walletLoad":"Move funds to a digital wallet owned by the same person"}},"purpose":{"description":"Specifies the purpose of the funds transfer. Required for some regions and use cases (eg crypto).","enum":["businessToBusiness","creditCardRepayment","crypto","crowdLending","debitCard","education","emergency","familySupport","gift","giftCard","gaming","highRiskSecurities","liquidAssets","medical","payroll","prepaidCard","salary","savings","travel","other"],"type":"string"},"recipient":{"type":"object","description":"An object containing details about the recipient of funds, including name and address information, as well as recipient account details. In many use cases, the recipient is the same person as the sender (for example if your customer uses their card to load funds into their own crypto exchange or investment account). __Although an optional object in the API schema, `recipient` is required for some regions and use cases.__","properties":{"account":{"type":"object","description":"An object for the account details of the recipient.","oneOf":[{"$ref":"#/components/schemas/fundsTransfer_bankAccount"},{"$ref":"#/components/schemas/fundsTransfer_card"},{"$ref":"#/components/schemas/fundsTransfer_wallet"},{"$ref":"#/components/schemas/fundsTransfer_storedValueWallet"},{"$ref":"#/components/schemas/fundsTransfer_stagedDigitalWallet"},{"$ref":"#/components/schemas/fundsTransfer_merchantWallet"},{"$ref":"#/components/schemas/fundsTransfer_email"},{"$ref":"#/components/schemas/fundsTransfer_phone"},{"$ref":"#/components/schemas/fundsTransfer_socialNetwork"}],"discriminator":{"propertyName":"type","mapping":{"bankAccount":"#/components/schemas/fundsTransfer_bankAccount","card":"#/components/schemas/fundsTransfer_card","wallet":"#/components/schemas/fundsTransfer_wallet","storedValueWallet":"#/components/schemas/fundsTransfer_storedValueWallet","stagedDigitalWallet":"#/components/schemas/fundsTransfer_stagedDigitalWallet","merchantWallet":"#/components/schemas/fundsTransfer_merchantWallet","email":"#/components/schemas/fundsTransfer_email","phone":"#/components/schemas/fundsTransfer_phone","socialNetwork":"#/components/schemas/fundsTransfer_socialNetwork"}}},"firstName":{"maxLength":35,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"Recipient's first name. Must be supplied if `lastName` or `middleName` are provided."},"middleName":{"maxLength":35,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"Recipient's middle name."},"lastName":{"maxLength":35,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"Recipient's last name. Must be supplied if `firstName` or `middleName` are provided."},"address":{"type":"object","description":"The recipient's address.","properties":{"address1":{"maxLength":255,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string","description":"Must be supplied if `city` is provided."},"address2":{"maxLength":255,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string"},"city":{"maxLength":100,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string","description":"Must be supplied if `address1` is provided."},"postalCode":{"maxLength":10,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string"},"state":{"maxLength":3,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"1-3 alphanumeric characters and spaces."},"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string","description":"Country code in [ISO 3166-1 Alpha-2 format](/products/reference/supported-countries-currencies#iso-country-codes)."}},"required":["countryCode"]},"dateOfBirth":{"type":"object","description":"Recipient's date of birth.","properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"]},"phoneNumber":{"type":"string","description":"Recipient's phone number.","maxLength":20,"minLength":3,"pattern":"^[0-9 ()+\\-/.x]*$"},"documentReference":{"maxLength":25,"minLength":1,"type":"string","description":"Recipient's document reference (e.g. Tax ID).","pattern":"^[A-Za-z0-9\\-\\/+.()]*$"}}},"sender":{"type":"object","description":"An object containing details about the sender of funds, including name and address information. The sender account is always the card account declared within `instruction.paymentInstrument`. __Although an optional object in the API schema, `sender` is required for some regions and use cases.__","properties":{"firstName":{"maxLength":35,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"Sender's first name. Must be supplied if `lastName` or `middleName` are provided."},"middleName":{"maxLength":35,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"Sender's middle name."},"lastName":{"maxLength":35,"minLength":1,"pattern":"^[-A-Za-z0-9_!@#$%()*=.:;?\\[\\]{}~`/+]*$","type":"string","description":"Sender's last name. Must be supplied if `firstName` or `middleName` are provided."},"address":{"type":"object","description":"The sender's address.","properties":{"address1":{"maxLength":255,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string","description":"Must be supplied if `city` is provided."},"address2":{"maxLength":255,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string"},"city":{"maxLength":100,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string","description":"Must be supplied if `address1` is provided."},"postalCode":{"maxLength":10,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string"},"state":{"maxLength":3,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"1-3 alphanumeric characters and spaces."},"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string","description":"Country code in [ISO 3166-1 Alpha-2 format](/products/reference/supported-countries-currencies#iso-country-codes)."}},"required":["countryCode"]},"dateOfBirth":{"type":"object","description":"Sender's date of birth.","properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"]},"documentReference":{"maxLength":25,"minLength":1,"type":"string","description":"Sender's document reference (e.g. Tax ID)."}}}}},"routing":{"type":"object","description":"An object containing specific routing preferences.","properties":{"fundingType":{"type":"string","description":"Specifies the credit or debit functionality of a combo card.","enum":["credit","debit"]},"preferredCardBrand":{"type":"string","enum":["visa","mastercard","maestro","amex","cartesBancaires","diners","dankort","jcb","discover","elo","eftposAU","unionPay"],"description":"Specifies your customer's preferred card brand to be used for the transaction using a co-badged card."}}},"recipient":{"type":"object","description":"Additional transaction recipient data.","properties":{"accountReference":{"maxLength":10,"minLength":1,"pattern":"^[a-zA-Z0-9]*$","type":"string","description":"Partial account reference of the primary recipient. Either partial card number (first 6 and last 4, no spaces), or a bank account number","example":"4444331111"},"lastName":{"maxLength":60,"minLength":1,"pattern":"^[a-zA-Z@!£*#$)(+-_=.,/;:'\" ]*$","type":"string","description":"The last name of the recipient. If for a business, then use the company name.","example":"Smith"},"address":{"type":"object","description":"Address of the recipient.","required":["postalCode"],"properties":{"postalCode":{"maxLength":7,"minLength":5,"pattern":"^[A-Z0-9 ]*$","type":"string","description":"The postal code of the recipient (UK only)"}}},"dateOfBirth":{"type":"object","description":"Birth date of the recipient.","required":["day","month","year"],"properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}}}}},"shipping":{"type":"object","description":"An object containing shipping details.","properties":{"sender":{"type":"object","properties":{"address":{"type":"object","description":"An object containing sender's (shipped from) address.","properties":{"postalCode":{"maxLength":10,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string"}}}}},"recipient":{"type":"object","properties":{"address":{"type":"object","description":"An object containing recipient's shipping address.","properties":{"countryCode":{"maxLength":2,"minLength":2,"pattern":"^[A-Z]*$","type":"string"},"postalCode":{"maxLength":10,"minLength":1,"pattern":"^[a-zA-Z0-9 ]*$","type":"string"}}}}}}},"order":{"type":"object","description":"An object containing details about the order.","properties":{"taxExempt":{"type":"boolean","description":"A flag to indicate whether the purchase is exempt from tax. Must be set to `true` if `order.salesTax` is 0."},"orderDate":{"type":"object","description":"Date of the order.","properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"]},"items":{"description":"Array of order items. You can send up to 99 individual order objects within this array.","items":{"type":"object","required":["name"],"properties":{"commodityCode":{"maxLength":12,"minLength":1,"type":"string","description":"Commodity code as defined by the National Institute of Governmental Purchasing.","pattern":"^[A-Za-z0-9@!£*#$)(-+_=.,/;:'\"]{1,12}$","example":"ABC123@#"},"totalTaxAmount":{"type":"integer","description":"Total tax amount for the item(s)."},"unitCost":{"type":"integer","description":"The price of one unit of the item purchased."},"totalAmount":{"type":"integer","description":"Total cost of the item(s) including tax."},"totalAmountNoTax":{"type":"integer","description":"Total cost of the item(s) excluding tax."},"unitOfMeasure":{"maxLength":8,"minLength":1,"type":"string","description":"The unit of measure of the purchased item. Explains how to interpret `items.quantity` field, e.g. quantity = 15, unitOfMeasure = kg.","pattern":"^[A-Za-z0-9@!£*#$)(+_=.,/;:'\"-]{1,8}$"},"name":{"maxLength":26,"minLength":1,"type":"string","description":"Name of the item(s).","pattern":"^[A-Za-z0-9 @!£*#$)(+_=.,/;:'\"-]{1,26}$"},"quantity":{"type":"integer","description":"Number of items purchased."},"productCode":{"maxLength":12,"minLength":1,"type":"string","description":"Merchant defined product code.","pattern":"^[A-Za-z0-9@!£*#\\$)(+_=.,/;:'\"-]{1,12}$"},"totalDiscountAmount":{"type":"integer","description":"Total discount amount for the item(s)."}}},"type":"array"},"dutyAmount":{"type":"integer","description":"Total amount of duty costs for the order."},"salesTax":{"type":"integer","description":"Total amount of sales tax for the order. Must be provided if `merchant.taxReference` is supplied."},"shippingAmount":{"type":"integer","description":"Total amount of shipping costs for the order."},"invoiceReference":{"maxLength":15,"minLength":1,"type":"string","description":"Invoice reference for the order.","pattern":"^[A-Za-z0-9 @!£*#\\$)\\(+_=.,/;:'\"-]{1,15}$"},"discountAmount":{"type":"integer","description":"Total amount of discounts for the order."}}},"industryData":{"type":"object","description":"An object containing industry specific order data.","properties":{"type":{"enum":["airline"],"type":"string"},"airlineName":{"type":"string","description":"The name of the airline (displayed as it would be on a bill).","example":"Cobb Air","minLength":1,"maxLength":256,"pattern":"^[A-Za-z0-9 @!£*#\\$()\\+\\-_=.,\\/;:'\"]+$"},"ticket":{"type":"object","description":"An object containing ticket details.","properties":{"number":{"type":"string","description":"The ticket number.","example":"123","minLength":1,"maxLength":16,"pattern":"^[A-Za-z0-9]+$"},"issuerAddress":{"type":"object","description":"An object containing the ticket issuer's address.","properties":{"address1":{"type":"string","minLength":1,"maxLength":255,"pattern":"^[A-Za-z0-9 ]+$"},"city":{"type":"string","minLength":1,"maxLength":100,"pattern":"^[A-Za-z0-9 ]+$"},"countryCode":{"type":"string","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$"},"postalCode":{"type":"string","minLength":1,"maxLength":10,"pattern":"^[A-Za-z0-9 ]+$"}},"required":["address1","city","countryCode","postalCode"]},"flightDetails":{"description":"An array with objects containing flight details. Each object represents one leg of a flight and you can submit up to four flight legs within this array.","items":{"type":"object","properties":{"fareClassCode":{"type":"string","description":"The code used by airlines to identify a fare type.","minLength":1,"maxLength":15,"pattern":"^[A-Za-z0-9]+$"},"departureAirport":{"type":"string","description":"The three letter IATA Airport Code for the departure airport.","example":"LHR","minLength":3,"maxLength":3,"pattern":"^[A-Z]{3}$"},"arrivalAirport":{"type":"string","description":"The three letter IATA Airport Code for the destination airport.","example":"SYD","minLength":3,"maxLength":3,"pattern":"^[A-Z]{3}$"},"carrierCode":{"type":"string","description":"Same as `industryData.airlineCode`, the code represents the airline for the specific flight leg.","example":"M1","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$"},"fareBasisCode":{"type":"string","description":"An optional extension to the `fareClassCode` for custom codes.","example":"TMYA","minLength":1,"maxLength":15,"pattern":"^[A-Za-z0-9]+$"},"flightCode":{"type":"string","description":"The flight code.","example":"501","minLength":1,"maxLength":5,"pattern":"^[0-9]+$"},"departureDate":{"type":"object","description":"An object containing the date of the departure.","properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"]},"stopOver":{"type":"boolean","description":"Set to `true` if this flight leg is a stopover, connecting different destinations."},"taxAmount":{"type":"integer","description":"The tax amount for this specific flight leg.","example":3500}},"required":["carrierCode","flightCode","departureAirport","arrivalAirport","departureDate","fareClassCode","taxAmount"]},"type":"array"},"restricted":{"type":"boolean","description":"Typically, restricted airfares require approval and e-ticket processing within 24 hours of making the reservation, are not transferable if cancelled, and can have specific requirements on when or whether a cancelled ticket can be rebooked. You must define if the ticket is restricted, but this does not affect the payment flows."},"issueDate":{"type":"object","description":"An object containing the ticket's issue date.","properties":{"day":{"type":"integer"},"month":{"type":"integer"},"year":{"type":"integer"}},"required":["day","month","year"]}},"required":["number","restricted","issuerAddress"]},"agentName":{"type":"string","description":"The name of the travel agent.","example":"J Small and Co","minLength":1,"maxLength":26,"pattern":"^[A-Za-z0-9 @!£*#\\$()\\+\\-_=.,\\/;:'\"]+$"},"agentCode":{"type":"string","description":"The IATA travel agency code.","example":"12345678","minLength":1,"maxLength":8,"pattern":"^[0-9]+$"},"invoiceReference":{"type":"string","description":"Billing Settlement Plan invoice reference.","minLength":1,"maxLength":14,"pattern":"^[A-Za-z0-9]+$"},"airlineCode":{"type":"string","description":"The two character IATA airline code.","example":"CA","minLength":2,"maxLength":2,"pattern":"^[A-Z]{2}$"},"passenger":{"type":"object","description":"An object containing passenger details.","properties":{"code":{"type":"string","minLength":1,"maxLength":15,"pattern":"^[A-Za-z0-9]+$"},"firstName":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[A-Za-z @!£*#\\$()\\+\\-_=.,\\/;:'\"]+$"},"lastName":{"type":"string","minLength":1,"maxLength":60,"pattern":"^[A-Za-z @!£*#\\$()\\+\\-_=.,\\/;:'\"]+$"}},"required":["code","firstName","lastName"]}},"required":["type","ticket","airlineName","airlineCode","agentCode","passenger"]},"merchantInitiatedTransaction":{"required":["transactionReference","merchant","instruction"],"type":"object","properties":{"transactionReference":{"$ref":"#/components/schemas/transactionReference"},"orderReference":{"$ref":"#/components/schemas/orderReference"},"merchant":{"required":["entity"],"type":"object","description":"An object that contains information about the merchant.","properties":{"entity":{"$ref":"#/components/schemas/entity"},"mcc":{"$ref":"#/components/schemas/mcc"},"paymentFacilitator":{"$ref":"#/components/schemas/paymentFacilitator"},"taxReference":{"$ref":"#/components/schemas/taxReference"}}},"instruction":{"required":["value","narrative","paymentInstrument","requestAutoSettlement","customerAgreement"],"type":"object","description":"An object that contains all information related to the payment.","properties":{"requestAutoSettlement":{"type":"object","description":"Indicates whether the transaction should be sent for settlement now `true` or later `false`, at a time of your choosing.","properties":{"enabled":{"type":"boolean"}}},"value":{"allOf":[{"$ref":"#/components/schemas/value"},{"type":"object","properties":{"acceptPartialAmount":{"type":"boolean","description":"Set to `true` to accept partial authorization amount. The remainder of the amount can be charged using a different payment credential via a new authorization request.\n\n **Note:** `requestAutoSettlement` must be `false` for partial authorizations."},"surchargeAmount":{"type":"integer","description":"The charging amount representing processing and service fees. Ensure that the `surchargeAmount` complies with local regulations and card network rules before applying.\n\n **Note:** The `surchargeAmount` is included in the total transaction amount, e.g. if the `value.surchargeAmount` is $20 and the `value.amount` is $100, then the actual cost of goods/services is $80."},"convenienceAmount":{"type":"integer","description":"The charging amount representing the offer of a convenient payment method or channel (such as online booking fee). Ensure that the `convenienceAmount` complies with local regulations and card network rules before applying.\n\n **Note:** The convenience fee is included in the total transaction amount, e.g. if the `value.convenienceAmount` is $20 and the `value.amount` is $100, then the actual cost of goods/services is $80."}}}]},"narrative":{"$ref":"#/components/schemas/narrative"},"paymentInstrument":{"type":"object","oneOf":[{"$ref":"#/components/schemas/card_plain_mit"},{"$ref":"#/components/schemas/card_token_mit"},{"$ref":"#/components/schemas/card_networkToken"},{"$ref":"#/components/schemas/card_networkToken_applepay"},{"$ref":"#/components/schemas/card_networkToken_googlepay"}],"discriminator":{"mapping":{"card/plain":"#/components/schemas/card_plain_mit","card/token":"#/components/schemas/card_token_mit","card/networkToken":"#/components/schemas/card_networkToken","card/networkToken+applepay":"#/components/schemas/card_networkToken_applepay","card/networkToken+googlepay":"#/components/schemas/card_networkToken_googlepay"},"propertyName":"type"}},"customerAgreement":{"type":"object","description":"Contains specific customer agreements for the transaction.","oneOf":[{"$ref":"#/components/schemas/mit_subscription"},{"$ref":"#/components/schemas/mit_installment"},{"$ref":"#/components/schemas/mit_unscheduled"},{"$ref":"#/components/schemas/mit_reauthorization"},{"$ref":"#/components/schemas/mit_resubmission"},{"$ref":"#/components/schemas/mit_noShow"},{"$ref":"#/components/schemas/mit_delayedCharge"}],"discriminator":{"propertyName":"type","mapping":{"subscription":"#/components/schemas/mit_subscription","installment":"#/components/schemas/mit_installment","unscheduled":"#/components/schemas/mit_unscheduled","reauthorization":"#/components/schemas/mit_reauthorization","resubmission":"#/components/schemas/mit_resubmission","noShow":"#/components/schemas/mit_noShow","delayedCharge":"#/components/schemas/mit_delayedCharge"}}},"consumerBillPayment":{"$ref":"#/components/schemas/consumerBillPayment"},"requestAccountUpdater":{"$ref":"#/components/schemas/requestAccountUpdater"},"debtRepayment":{"$ref":"#/components/schemas/debtRepayment"},"fundsTransfer":{"$ref":"#/components/schemas/fundsTransfer"},"routing":{"$ref":"#/components/schemas/routing"}}},"recipient":{"$ref":"#/components/schemas/recipient"},"shipping":{"$ref":"#/components/schemas/shipping"},"order":{"$ref":"#/components/schemas/order"},"customer":{"type":"object","description":"Additional customer data.","properties":{"documentReference":{"type":"string","description":"Required for domestic processing in some Latin American countries.","minLength":1,"maxLength":50},"reference":{"type":"string","description":"Merchant-generated customer reference.","minLength":1,"maxLength":17},"emailAddress":{"type":"string","description":"Customer's email address. If enabled by your configuration, your customer will receive the transaction outcome at this email address.","minLength":1,"maxLength":128}}},"industryData":{"$ref":"#/components/schemas/industryData"},"riskProfile":{"type":"string","description":"Used to update the FraudSight data model to benefit future payments.","example":"https://try.access.worldpay.com/riskProfile/{linkData}"}}}}}},"schemaResolvedErrors":[]},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"enable-additional-features","__idx":3},"children":["Enable additional features"]},{"$$mdtype":"Tag","name":"Cards","attributes":{"columns":4,"cardMinWidth":180},"children":[{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Account Updater","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"filled","to":"/products/card-payments/features/account-updater"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Reduce declines and improve your customer's experience by automatically retrieving updated card details in real time."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Airline data","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"filled","to":"/products/card-payments/features/l2-l3-airlines"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supply detailed airline itinerary data to achieve several cost and efficiency benefits."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Co-branded cards","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"filled","to":"/products/card-payments/features/co-branded-cards"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Take payments from cards that carry multiple card brands."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Corporate purchasing data (level 2 / 3)","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"filled","to":"/products/card-payments/features/l2-l3-purchasing"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Submit additional order, tax, and line item data in your payment authorization and settlement requests where your customer is using a commercial or purchasing card."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Financial Services (MCC 6012/6051)","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"filled","to":"/products/card-payments/features/financial-services"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Supply additional mandatory data if you offer financial services, debt repayments, or consumer bill payments."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Funding Transactions (AFT)","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"filled","to":"/products/card-payments/features/funds-transfers"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Take Account Funding Transactions (AFTs) to pull funds from a card account to another destination."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Latin America payments","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"filled","to":"/products/card-payments/features/latam-payments"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Take payments in Latin America, including regional installment plan options, combo cards, and supplying customer document references."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"Partial authorizations","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"filled","to":"/products/card-payments/features/partial-authorizations"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accept authorizations for partial amounts."]}]},{"$$mdtype":"Tag","name":"Card","attributes":{"title":"View all features","imagePosition":"start","iconPosition":"auto","layout":"vertical","align":"center","variant":"outlined","to":"/products/card-payments/features"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"response","__idx":4},"children":["Response"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Best practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Access Worldpay returns a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WP-CorrelationId"]}," in the headers of service responses. We ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["highly recommend"]}," you log this. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WP-CorrelationId"]}," is used by us to examine individual service requests."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"successful-payment","__idx":5},"children":["Successful payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You receive:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an HTTP code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"outcome\": \"authorized\""]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Sent for Settlement\""]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentId"]}," - a unique identifier generated by us for a single payment. Generated at authorization, and maintained through successive payment actions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commandId"]}," - a unique identifier generated by us for a single instance of an interaction (command) with our API"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["risk factors (only returned if issuer identifies conflict)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#exemptions"},"children":["exemption result and reason"]}," (only if you supplied a risk profile to request an ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/sca-exemptions"},"children":["SCA exemption"]},")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an issuer authorization code"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["links to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/manage-payments#cancel-an-authorization"},"children":["cancel"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/manage-payments#settle-an-authorization"},"children":["settle"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/manage-payments#partially-settle-an-authorization"},"children":["partially settle"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/query-a-payment"},"children":["query your payment"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"paymentinstrument","__idx":6},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"paymentInstrument\""]}," object is returned if we are able to provide information related to the underlying card used in the authorization request.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":["Note that if the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}," object is returned, there is no guarantee that each field listed below will be returned with every transaction."]}]},{"$$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":["The type of paymentInstrument. E.g.:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/plain+masked"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/network+masked"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/network"]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.brand"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The card brand. Sometimes referred to as the network or scheme. E.g.: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["visa"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mastercard"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amex"]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.cardBin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The card bin. E.g.:",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["444433"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[" this may contain the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]}]}," character. "]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.lastFour"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The last four digits of the card. E.g.: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1111"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[" this may contain the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["*"]}]}," character, where the card number is less than 16 digits. "]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.expiryDate.month"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The card expiry month. E.g.: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["11"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.expiryDate.year"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The card expiry year. E.g.: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2025"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.fundingType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["How the card is funded. E.g.: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credit"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["debit"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["prepaid"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["deferredDebit"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["chargeCard"]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.category"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whether the card is classed as a consumer card or a card for commercial use. E.g.: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["consumer"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$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.countryCode"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The alpha-2 ISO-3166 country code that the card was issued in. May return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"N/A\""]}," where the country is unknown. E.g.: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GB"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.issuerName"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The name of the card issuer. E.g.: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Some Issuer PLC."]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.paymentAccountReference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment account reference (PAR) is a non-financial reference that uniquely identifies the underlying cardholder account. This allows you to correlate payments made with differing instruments (e.g. \"",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/plain\""]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"card/wallet+applepay\""]},"), where the same account funds the transaction. A PAR cannot be used to initiate a payment. E.g.: ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ABC123DEF456GHI789JKL123MNO45"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument.debitNetwork"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The debit network that the transaction was routed through. Returned optionally for subscribing merchants. See our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/openapi/other/authorize#other/authorize/t=response&c=201&path=&d=0/paymentinstrument/debitnetwork"},"children":["API reference"]}," for all possible values."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"refused-payment","__idx":7},"children":["Refused payment"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You receive:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an HTTP code ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["201"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"outcome\": \"refused\""]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentId"]}," - a unique identifier generated by us for a single payment. Generated at authorization, and maintained through successive payment actions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["commandId"]}," - a unique identifier generated by us for a single instance of an interaction (command) with our API"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refusalCode"]}," containing either our standard ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/refusal-response"},"children":["refusal codes"]}," or the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/refusal-response/scheme-codes"},"children":["rawCode"]}," (if enabled)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["refusalDescription"]}," which gives additional context on the refusal"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/refusal-response#refusal-advice-codes"},"children":["advice code"]}," (only if returned by the card scheme and acquirer)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["risk factors (only returned if issuer identifies conflict)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"example-response","__idx":8},"children":["Example response"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Card/Token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/cit/responses/cit-response-authorized.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"authorized\",\n    \"paymentId\": \"pay-fh47sbnaKR28AuocN28x0\",\n    \"commandId\": \"cmdfHx982Nbhsklg91hsvlrv0\",\n    \"riskFactors\": [\n        {\n            \"type\": \"cvc\",\n            \"risk\": \"notSupplied\"\n        },\n        {\n            \"type\": \"avs\",\n            \"risk\": \"notChecked\",\n            \"detail\": \"address\"\n        },\n        {\n            \"type\": \"avs\",\n            \"risk\": \"notChecked\",\n            \"detail\": \"postcode\"\n        }\n    ],\n    \"issuer\": {\n        \"authorizationCode\": \"12345A\"\n    },\n    \"scheme\": {\n        \"reference\": \"060720116005060\"\n    },\n    \"paymentInstrument\": {\n        \"type\": \"card/plain+masked\",\n        \"cardBin\": \"444433\",\n        \"lastFour\": \"1111\",\n        \"category\": \"consumer\",\n        \"expiryDate\": {\n            \"month\": 5,\n            \"year\": 2035\n        },\n        \"cardBrand\": \"visa\",\n        \"fundingType\": \"credit\",\n        \"issuerName\": \"Some Issuer PLC\",\n        \"paymentAccountReference\": \"Q1HJZ28RKA1EBL470G9XYG90R5D3E\"\n    },\n    \"_links\": {\n        \"cardPayments:cancel\": {\n            \"href\": \"https://try.access.worldpay.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiI=\"\n        },\n        \"cardPayments:partialCancel\": {\n            \"href\": \"https://try.access.worldpay.com/payments/authorizations/cancellations/partials/eyJrIjoiazNhYjYzMiJ9\"\n        },\n        \"cardPayments:settle\": {\n            \"href\": \"https://try.access.worldpay.com/payments/settlements/full/eyJrIjoiazNhYjYzMiI=\"\n        },\n        \"cardPayments:partialSettle\": {\n            \"href\": \"https://try.access.worldpay.com/payments/settlements/partials/eyJrIjoiazNhYjYzMiI=\"\n        },\n        \"cardPayments:events\": {\n            \"href\": \"https://try.access.worldpay.com/payments/events/eyJrIjoiazNhYjYzMiI=\"\n        },\n        \"curies\": [\n            {\n                \"name\": \"cardPayments\",\n                \"href\": \"https://try.access.worldpay.com/rels/cardPayments/{rel}\",\n                \"templated\": true\n            }\n        ]\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Network Token","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/cit/responses/cit-response-networkToken-authorized.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"authorized\",\n    \"paymentId\": \"pay3N_87du2Sj-3HndV826xn0\",\n    \"commandId\": \"cmdwZ5y_rSV1VmjD6CpgCuXG0\",\n    \"riskFactors\": [\n        {\n            \"type\": \"cvc\",\n            \"risk\": \"notSupplied\"\n        },\n        {\n            \"type\": \"avs\",\n            \"risk\": \"notMatched\",\n            \"detail\": \"address\"\n        },\n        {\n            \"type\": \"avs\",\n            \"risk\": \"notChecked\",\n            \"detail\": \"postcode\"\n        }\n    ],\n    \"issuer\": {\n        \"authorizationCode\": \"12345A\"\n    },\n    \"scheme\": {\n        \"reference\": \"060720116005060\"\n    },\n    \"paymentInstrument\": {\n        \"type\": \"card/network\",\n        \"cardBin\": \"444433\",\n        \"expiryDate\": {\n            \"month\": 5,\n            \"year\": 2035\n        },\n        \"paymentAccountReference\": \"Q1HJZ28RKA1EBL470G9XYG90R5D3E\"\n    },\n    \"_links\": {\n        \"cardPayments:cancel\": {\n            \"href\": \"https://try.access.worldpay.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiI\"\n        },\n        \"cardPayments:partialCancel\": {\n            \"href\": \"https://try.access.worldpay.com/payments/authorizations/cancellations/partials/eyJrIjoiazNhYjYzMiJ9\"\n        },        \n        \"cardPayments:settle\": {\n            \"href\": \"https://try.access.worldpay.com/payments/settlements/full/eyJrIjoiazNhYjYzMiI\"\n        },\n        \"cardPayments:partialSettle\": {\n            \"href\": \"https://try.access.worldpay.com/payments/settlements/partials/eyJrIjoiazNhYjYzMiI\"\n        },\n        \"cardPayments:events\": {\n            \"href\": \"https://try.access.worldpay.com/payments/events/eyJrIjoiazNhYjYzMiI\"\n        },\n        \"curies\": [\n            {\n                \"name\": \"cardPayments\",\n                \"href\": \"https://try.access.worldpay.com/rels/cardPayments/{rel}\",\n                \"templated\": true\n            }\n        ]\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Refusal","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/cit/responses/cit-response-refused.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"refused\",\n    \"paymentId\": \"pay29GnajUy2fBzC9552U_1b0\",\n    \"commandId\": \"cmd9xmr5cSNtUulYlYW8kbY80\",\n    \"refusalCode\": \"83\",\n    \"refusalDescription\": \"Fraud/Security related reasons\",\n    \"riskFactors\": [\n        {\n            \"type\": \"riskProfile\",\n            \"risk\": \"verificationFailed\"\n        },\n        {\n            \"type\": \"cvc\",\n            \"risk\": \"notMatched\"\n        },\n        {\n            \"type\": \"avs\",\n            \"risk\": \"notMatched\",\n            \"detail\": \"address\"\n        },\n        {\n            \"type\": \"avs\",\n            \"risk\": \"notChecked\",\n            \"detail\": \"postcode\"\n        }\n    ]\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Account Updater","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/cit/responses/account-updater.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"authorized\",\n    \"paymentId\": \"pay28NdG68sv-13_sDcu5Bwt0\",\n    \"commandId\": \"cmd8hJcb20_sh2-sbRjx88wL0\",\n    \"riskFactors\": [\n        {\n            \"type\": \"cvc\",\n            \"risk\": \"notSupplied\"\n        },\n        {\n            \"type\": \"avs\",\n            \"risk\": \"notChecked\",\n            \"detail\": \"address\"\n        },\n        {\n            \"type\": \"avs\",\n            \"risk\": \"notChecked\",\n            \"detail\": \"postcode\"\n        }\n    ],\n    \"issuer\": {\n        \"authorizationCode\": \"12345A\"\n    },\n    \"scheme\": {\n        \"reference\": \"060720116005060\"\n    },\n    \"updatedPaymentInstrument\": {\n        \"cardBin\": \"491183\",\n        \"lastFour\": \"0000\",\n        \"expiryDate\": {\n            \"month\": 9,\n            \"year\": 2031\n        },\n        \"cardBrand\": \"visa\",\n        \"fundingType\": \"credit\",\n        \"accountUpdaterMessage\": \"The account number was changed\",\n        \"type\": \"card/plain+masked\"\n    },\n    \"paymentInstrument\": {\n        \"type\": \"card/plain+masked\",\n        \"cardBin\": \"444433\",\n        \"lastFour\": \"1111\",\n        \"category\": \"consumer\",\n        \"expiryDate\": {\n            \"month\": 5,\n            \"year\": 2023\n        },\n        \"cardBrand\": \"visa\",\n        \"fundingType\": \"credit\",\n        \"issuerName\": \"Some Issuer PLC\",\n        \"paymentAccountReference\": \"Q1HJZ28RKA1EBL470G9XYG90R5D3E\"\n    },\n    \"_links\": {\n        \"cardPayments:cancel\": {\n            \"href\": \"https://try.access.worldpay.com/payments/authorizations/cancellations/eyJrIjoiazNhYjYzMiI=\"\n        },\n        \"cardPayments:partialCancel\": {\n            \"href\": \"https://try.access.worldpay.com/payments/authorizations/cancellations/partials/eyJrIjoiazNhYjYzMiJ9\"\n        },\n        \"cardPayments:settle\": {\n            \"href\": \"https://try.access.worldpay.com/payments/settlements/full/eyJrIjoiazNhYjYzMiI=\"\n        },\n        \"cardPayments:partialSettle\": {\n            \"href\": \"https://try.access.worldpay.com/payments/settlements/partials/eyJrIjoiazNhYjYzMiI=\"\n        },\n        \"cardPayments:events\": {\n            \"href\": \"https://try.access.worldpay.com/payments/events/eyJrIjoiazNhYjYzMiI=\"\n        },\n        \"curies\": [\n            {\n                \"name\": \"cardPayments\",\n                \"href\": \"https://try.access.worldpay.com/rels/cardPayments/{rel}\",\n                \"templated\": true\n            }\n        ]\n    }\n}\n"},"children":[]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payments:settle"]}," action link to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/manage-payments#settle-an-authorization"},"children":["settle the payment"]}," straight away. Alternatively you can cache the response and use the link to settle the payment later."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In case of an error, you can get further information in our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/worldpay-error-responses"},"children":["error reference"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"riskfactors","__idx":9},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["riskFactors"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To reduce the probability of processing a fraudulent payment, supply your customer's billing address and cvc in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#complete-authorization-request-schema"},"children":["authorization request"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We check this with your customer's issuing bank and include any conflicts in our response."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["riskFactors"]}," array is returned ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["only if"]}," there is a risk associated with the authorization request. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["riskFactors"]}," array returns an object for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["avs"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvc"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["riskProfile"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["only if"]}," this information was included in the authorization request ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["and"]}," if any risk was identified."]},{"$$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"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cvc"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["riskProfile"]}]}]},{"$$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":["notChecked"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notMatched"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notSupplied"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["verificationFailed"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next steps"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/manage-payments#settle-an-authorization"},"children":["Settle a payment"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/manage-payments#fully-refund-an-authorization"},"children":["Refund a payment"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/manage-payments#cancel-an-authorization"},"children":["Cancel a payment"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/manage-payments#reverse-an-authorization"},"children":["Reverse a payment"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}]}]},"headings":[{"value":"Take repeat card payments","id":"take-repeat-card-payments","depth":1},{"value":"Merchant Initiated Transactions","id":"merchant-initiated-transactions","depth":2},{"value":"Schema (parameters)","id":"schema-parameters","depth":3},{"value":"Enable additional features","id":"enable-additional-features","depth":3},{"value":"Response","id":"response","depth":2},{"value":"Successful payment","id":"successful-payment","depth":3},{"value":"paymentInstrument","id":"paymentinstrument","depth":4},{"value":"Refused payment","id":"refused-payment","depth":3},{"value":"Example response","id":"example-response","depth":4},{"value":"riskFactors","id":"riskfactors","depth":4}],"frontmatter":{"seo":{"title":"Take repeat card payments"}},"lastModified":"2026-06-17T13:20:04.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/card-payments/repeat-payments","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}