{"templateId":"markdown","versions":[{"version":"v5","label":"v5","link":"/products/card-payments/v5/repeatwallets","default":false,"active":false,"folderId":"5e391095"},{"version":"v6","label":"v6","link":"/products/card-payments/v6/repeatwallets","default":false,"active":true,"folderId":"5e391095"},{"version":"v7","label":"v7 (Latest)","link":"/products/card-payments/repeatwallets","default":true,"active":false,"folderId":"5e391095"}],"sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["partial","admonition","tabs","tab","code-snippet"]},"custom_product":"Card Payments","type":"markdown"},"seo":{"title":"Repeat Wallet 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":[],"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":"repeat-wallet-payments","__idx":0},"children":["Repeat Wallet Payments"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use our card on file resource to authorize a payment with a digital wallet."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You must ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallets"},"children":["integrate with Google Pay or Apple Pay"]}," before you can submit repeat wallet payments to our Payments API."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-are-card-on-file-payments","__idx":1},"children":["What are card on file payments?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The customer is actively participating in making a payment at the point of authorization using card details you have previously stored/ intend to store"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Does not follow a schedule"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Requires explicit permission from the customer to store the card on their account for use in a “one-click” model"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sometimes referred to as Customer Initiated Transactions (CIT)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Read more about card on file mandates ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/articles/repeat-payments"},"children":["here"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"card-on-file-authorization-request","__idx":2},"children":["Card on file authorization request"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST"]}," your initial card on file authorizations to our ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payments:cardOnFileAuthorize"]}," action link resource received in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/get-started#query-the-payments-root-resource"},"children":["query the payments root resource"]}," request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"card-on-file-authorization-example-request","__idx":3},"children":["Card on file authorization example 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/payments/authorizations/cardOnFile"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardOnFile"]}," authorization request body"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Apple Pay","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/cof/requests/authorization-request-apple-pay.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"narrative\": {\n            \"line1\": \"Mind Palace Ltd\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 250\n        },\n        \"paymentInstrument\": {\n            \"type\": \"card/wallet+applepay\",\n            \"walletToken\": \"{\\\"version\\\": \\\"EC_v1\\\",\\\"data\\\": \\\"kdHd..GQ==\\\",\\\"signature\\\": \\\"MIAGCSqGSIb3DQEH...AAA\\\",\\\"header\\\": {\\\"transactionId\\\": \\\"d3b28af..f8\\\",\\\"ephemeralPublicKey\\\": \\\"MFkwE..Q==\\\",\\\"publicKeyHash\\\": \\\"dxCK..6o=\\\"}}\"\n        }\n    }\n}\n"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Google Pay","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/cof/requests/authorization-request-google-pay.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n  \"transactionReference\": \"Memory265-13/08/1876\",\n  \"merchant\": {\n      \"entity\": \"default\"\n  },\n  \"instruction\": {\n    \"narrative\": {\n      \"line1\": \"Mind Palace Ltd\"\n    },\n    \"value\": {\n      \"currency\": \"GBP\",\n      \"amount\": 250\n    },\n    \"paymentInstrument\": {\n      \"type\": \"card/wallet+googlepay\",\n      \"walletToken\": \"{\\\"version\\\": \\\"EC_v1\\\",\\\"data\\\": \\\"kdHd..GQ==\\\",\\\"signature\\\": \\\"MIAGCSqGSIb3DQEH...AAA\\\",\\\"header\\\": {\\\"transactionId\\\": \\\"d3b28af..f8\\\",\\\"ephemeralPublicKey\\\": \\\"MFkwE..Q==\\\",\\\"publicKeyHash\\\": \\\"dxCK..6o=\\\"}}\"\n    }\n  }\n}\n"},"children":[]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"descriptions-of-your-authorization-request-parameters","__idx":4},"children":["Descriptions of your authorization request parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionReference"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":["unique"]}," reference generated by you that is used to identify a payment throughout its lifecycle. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/formatting#transaction-reference-format"},"children":["transaction reference format"]},", for more details and the best practices."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains information about the merchant."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant.entity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Direct your payment to assist with billing, reporting and reconciliation. This is mandatory for authentication and queries.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"Contact your Worldpay Implementation Manager for more details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains all the information related to the payment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.narrative"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The text that appears on your customer's statement. Used to identify the merchant.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/formatting#narrative-format"},"children":["narrative format"]}," for more details and best practices."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["narrative.line1"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["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.).",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/formatting#narrative-line1"},"children":["narrative ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["line1"]}," format"]}," for more details."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.value"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains information about the value of the payment."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value.currency"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The three digit currency code.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"See list of ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/useful-tables-v5-v6#currency-codes"},"children":["supported currencies"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["value.amount"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment amount. This is a whole number with an exponent e.g. if exponent is two, 250 is 2.50. You can find the relevant exponent in our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/reference/useful-tables-v5-v6#currency-codes"},"children":["currency table"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.paymentInstrument"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["✅"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["An object that contains the payment type and details. You must integrate with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/wallets/applepay"},"children":["Apple Pay"]}," first to use the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["card/wallet+applepay"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"optional-parameters","__idx":5},"children":["Optional parameters"]},{"$$mdtype":"Tag","name":"details","attributes":{},"children":[{"$$mdtype":"Tag","name":"summary","attributes":{},"children":["Optional parameters and descriptions"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instruction.intent"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A parameter detailing the reason for this particular repeat agreement. Possible value: ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["instalment"]}]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["narrative.line2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["❌"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Additional details about the payment e.g. order number, telephone number."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The requests below contain all the ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":["mandatory and optional"]}," fields needed for a successful card on file authorization request."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"full-authorization-request-body","__idx":6},"children":["Full authorization request body:"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Apple Pay","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/cof/requests/authorization-request-all-applepay.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"intent\": \"instalment\",\n        \"narrative\": {\n            \"line1\": \"Mind Palace Ltd\",\n            \"line2\": \"Memory265-13/08/1876\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 1000\n        },\n        \"paymentInstrument\": {\n            \"type\": \"card/wallet+applepay\",\n            \"walletToken\": \"{\\\"version\\\": \\\"EC_v1\\\",\\\"data\\\": \\\"kdHd..GQ==\\\",\\\"signature\\\": \\\"MIAGCSqGSIb3DQEH...AAA\\\",\\\"header\\\": {\\\"transactionId\\\": \\\"d3b28af..f8\\\",\\\"ephemeralPublicKey\\\": \\\"MFkwE..Q==\\\",\\\"publicKeyHash\\\": \\\"dxCK..6o=\\\"}}\",\n            \"billingAddress\": {\n                \"address1\": \"221B Baker Street\",\n                \"address2\": \"Marylebone\",\n                \"address3\": \"Westminster\",\n                \"postalCode\": \"NW1 6XE\",\n                \"city\": \"London\",\n                \"state\": \"Greater London\",\n                \"countryCode\": \"GB\"\n            }\n        }\n    }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Google Pay","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/cof/requests/authorization-request-all-google-pay.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"intent\": \"instalment\",\n        \"narrative\": {\n            \"line1\": \"Mind Palace Ltd\",\n            \"line2\": \"Memory265-13/08/1876\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 1000\n        },\n        \"paymentInstrument\": {\n            \"type\": \"card/wallet+googlepay\",\n            \"walletToken\": \"{\\\"version\\\": \\\"EC_v1\\\",\\\"data\\\": \\\"kdHd..GQ==\\\",\\\"signature\\\": \\\"MIAGCSqGSIb3DQEH...AAA\\\",\\\"header\\\": {\\\"transactionId\\\": \\\"d3b28af..f8\\\",\\\"ephemeralPublicKey\\\": \\\"MFkwE..Q==\\\",\\\"publicKeyHash\\\": \\\"dxCK..6o=\\\"}}\",\n            \"billingAddress\": {\n                \"address1\": \"221B Baker Street\",\n                \"address2\": \"Marylebone\",\n                \"address3\": \"Westminster\",\n                \"postalCode\": \"NW1 6XE\",\n                \"city\": \"London\",\n                \"state\": \"Greater London\",\n                \"countryCode\": \"GB\"\n            }\n        }\n    }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Apple Pay","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/authorize/requests/authorization-request-apple-pay.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"narrative\": {\n            \"line1\": \"Mind Palace Ltd\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 250\n        },\n        \"paymentInstrument\": {\n            \"type\": \"card/wallet+applepay\",\n            \"walletToken\": \"{\n                \\\"version\\\": \\\"EC_v1\\\",\n                \\\"data\\\": \\\"kdHd..GQ==\\\",\n                \\\"signature\\\": \\\"MIAGCSqGSIb3DQEH...AAA\\\",\n                \\\"header\\\": {\n                    \\\"transactionId\\\": \\\"d3b28af..f8\\\",\n                    \\\"ephemeralPublicKey\\\": \\\"MFkwE..Q==\\\",\n                    \\\"publicKeyHash\\\": \\\"dxCK..6o=\\\" \n                }\n            }\"\n        }\n    }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Google Pay","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/authorize/requests/authorization-request-google-pay.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"transactionReference\": \"Memory265-13/08/1876\",\n    \"merchant\": {\n        \"entity\": \"default\"\n    },\n    \"instruction\": {\n        \"narrative\": {\n            \"line1\": \"Mind Palace Ltd\"\n        },\n        \"value\": {\n            \"currency\": \"GBP\",\n            \"amount\": 250\n        },\n        \"paymentInstrument\": {\n            \"type\": \"card/wallet+googlepay\",\n            \"walletToken\": \"{\\\"protocolVersion\\\":\\\"ECv1\\\",\\\"signature\\\":\\\"MEQCIH6Q4OwQ0jAceFEkGF0JID6sJNXxOEi4r+mA7biRxqBQAiAondqoUpU/bdsrAOpZIsrHQS9nwiiNwOrr24RyPeHA0Q\\\\u003d\\\\u003d\\\",\\\"signedMessage\\\":\\\"{\\\\\\\"tag\\\\\\\":\\\\\\\"jpGz1F1Bcoi/fCNxI9n7Qrsw7i7KHrGtTf3NrRclt+U\\\\\\\\u003d\\\\\\\",\\\\\\\"ephemeralPublicKey\\\\\\\":\\\\\\\"BJatyFvFPPD21l8/uLP46Ta1hsKHndf8Z+tAgk+DEPQgYTkhHy19cF3h/bXs0tWTmZtnNm+vlVrKbRU9K8+7cZs\\\\\\\\u003d\\\\\\\",\\\\\\\"encryptedMessage\\\\\\\":\\\\\\\"mKOoXwi8OavZ\\\\\\\"}\\\"}\"\n        }\n    }\n}"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"card-on-file-response","__idx":7},"children":["Card on file 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-response","__idx":8},"children":["Successful response"]},{"$$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\""]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["risk factors (only returned if issuer identifies conflict)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a scheme reference"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paymentInstrument"]}," detailing brand information about the card that was used"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["links to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/manage-payments#cancel-an-authorization"},"children":["cancel"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/manage-payments#settle-an-authorization"},"children":["settle"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/manage-payments#partially-settle-an-authorization"},"children":["partially settle"]}," or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/query-a-payment"},"children":["track"]}," payment events"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an authorization link for the next card on file payment in your repeat payment agreement"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an authorization link for the next recurring payment in your repeat payment agreement"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a token link, you must use for all subsequent payments in your repeat payment agreement"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"refused-response","__idx":9},"children":["Refused response"]},{"$$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":"MarkdownLink","attributes":{"href":"/products/reference/refusal-response"},"children":["refusal code"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}," which gives additional context on the refusal"]},{"$$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":10},"children":["Example response"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Successful","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/cof/responses/authorization-response-wallets.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"authorized\",\n    \"riskFactors\": [{\n            \"risk\": \"not_checked\",\n            \"detail\": \"postcode\",\n            \"type\": \"avs\"\n        },\n        {\n            \"risk\": \"not_checked\",\n            \"detail\": \"address\",\n            \"type\": \"avs\"\n        }\n    ],\n    \"scheme\": {\n        \"reference\": \"schemeReference\"\n    },\n    \"paymentInstrument\": {\n        \"type\": \"card/network+masked\",\n        \"card\": {\n            \"number\": {\n                \"bin\": \"444433\",\n                \"last4Digits\": \"1111\",\n                \"dpan\": \"4444333322221111\"\n            },\n            \"countryCode\": \"GB\",\n            \"expiryDate\": {\n                \"month\": 6,\n                \"year\": 2021\n            },\n            \"brand\": \"visa\",\n            \"fundingType\": \"debit\",\n            \"issuer\": {\n                \"name\": \"VALID_ISSUER\"\n            },\n            \"paymentAccountReference\": \"somePAR\"\n        }\n    },\n    \"_links\": {\n        \"payments:cancel\": {\n            \"href\": \"https://try.access.worldpay.com/payments/authorizations/cancellations/eyJrIjoiazUyOTVhMSIsImxpbmtWZXJzaW9uIjoiMy4wLjAifQ==.7uyuNo1ShOgM5rTwStg86LXzb0a2wdLW1lwX:DIQ2Ecrp4gw65VLnHmjsAVqzpa2NcwixaBb2p8R2x5NPXdRpybJ2ndKlbkNOc9gj+ruN20iaTdYqv2FNgB3ZAw3g+yyUMUlQDFD8DU++ZswXpUQe8YTBHmTP8zHQUXrSORn9IaI6kzJnMu2HWwEJOqKnWLvRCMy:fr4ptatJJrmRVON8WTjisJL:sd3TJ9uDcO:gD+q+Q01y++Mzop0k8y3bDcnNBpsG:8xf4uKGGYO3EcAWA==\"\n        },\n        \"payments:settle\": {\n            \"href\": \"https://try.access.worldpay.com/payments/settlements/full/eyJrIjoiazUyOTVhMSIsImxpbmtWZXJzaW9uIjoiMy4wLjAifQ==.7uyuNo1ShOgM5rTwStg86LXzb0a2wdLW1lwX:DIQ2Ecrp4gw65VLnHmjsAVqzpa2NcwixaBb2p8R2x5NPXdRpybJ2ndKlbkNOc9gj+ruN20iaTdYqv2FNgB3ZAw3g+yyUMUlQDFD8DU++ZswXpUQe8YTBHmTP8zHQUXrSORn9IaI6kzJnMu2HWwEJOqKnWLvRCMy:fr4ptatJJrmRVON8WTjisJL:sd3TJ9uDcO:gD+q+Q01y++Mzop0k8y3bDcnNBpsG:8xf4uKGGYO3EcAWA==\"\n        },\n        \"payments:partialSettle\": {\n            \"href\": \"https://try.access.worldpay.com/payments/settlements/partials/eyJrIjoiazUyOTVhMSIsImxpbmtWZXJzaW9uIjoiMy4wLjAifQ==.7uyuNo1ShOgM5rTwStg86LXzb0a2wdLW1lwX:DIQ2Ecrp4gw65VLnHmjsAVqzpa2NcwixaBb2p8R2x5NPXdRpybJ2ndKlbkNOc9gj+ruN20iaTdYqv2FNgB3ZAw3g+yyUMUlQDFD8DU++ZswXpUQe8YTBHmTP8zHQUXrSORn9IaI6kzJnMu2HWwEJOqKnWLvRCMy:fr4ptatJJrmRVON8WTjisJL:sd3TJ9uDcO:gD+q+Q01y++Mzop0k8y3bDcnNBpsG:8xf4uKGGYO3EcAWA==\"\n        },\n        \"payments:events\": {\n            \"href\": \"https://try.access.worldpay.com/payments/events/eyJrIjoiazUyOTVhMSIsImxpbmtWZXJzaW9uIjoiMy4wLjAifQ==.7uyuNo1ShOgM5rTwStg86LXzb0a2wdLW1lwX:DIQ2Ecrp4gw65VLnHmjsAVqzpa2NcwixaBb2p8R2x5NPXdRpybJ2ndKlbkNOc9gj+ruN20iaTdYqv2FNgB3ZAw3g+yyUMUlQDFD8DU++ZswXpUQe8YTBHmTP8zHQUXrSORn9IaI6kzJnMu2HWwEJOqKnWLvRCMy:fr4ptatJJrmRVON8WTjisJL:sd3TJ9uDcO:gD+q+Q01y++Mzop0k8y3bDcnNBpsG:8xf4uKGGYO3EcAWA==\"\n        },\n        \"payments:cardOnFileAuthorize\": {\n            \"href\": \"https://try.access.worldpay.com/payments/authorizations/cardOnFile/eyJrIjoiazUyOTVhMSIsImxpbmtWZXJzaW9uIjoiMS4wLjAifQ==.R6PzeBs1kC+VT5dtn2WKHquYi:0CPtdsTmoC0CiPjw6CkE+Ujvons6ZVs+R2JwUJmXAx1+34Kz67cP9hSVZNkQ==\"\n        },\n        \"payments:recurringAuthorize\": {\n            \"href\": \"https://try.access.worldpay.com/payments/authorizations/recurring/eyJrIjoiazUyOTVhMSIsImxpbmtWZXJzaW9uIjoiMS4wLjAifQ==.R6PzeBs1kC+VT5dtn2WKHquYi:0CPtdsTmoC0CiPjw6CkE+Ujvons6ZVs+R2JwUJmXAx1+34Kz67cP9hSVZNkQ==\"\n        },\n        \"tokens:token\": {\n            \"href\": \"https://access.worldpay.com/tokens/linkData\"\n        },\n        \"curies\": [{\n            \"name\": \"payments\",\n            \"href\": \"https://try.access.worldpay.com/rels/payments/{rel}\",\n            \"templated\": true\n        }]\n    }\n}"},"children":[]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Google Pay","disable":false},"children":[{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"file":"./code/cof/responses/authorization-response-refused-wallets.json","language":"json","header":{"controls":{"copy":{}}},"lang":"json","source":"{\n    \"outcome\": \"refused\",\n    \"description\": \"do not honour\",\n    \"code\": \"5\",\n    \"refusalAdvice\": {\n        \"code\": \"03\"\n    },\n    \"riskFactors\": [{\n            \"risk\": \"not_checked\",\n            \"detail\": \"postcode\",\n            \"type\": \"avs\"\n        },\n        {\n            \"risk\": \"not_checked\",\n            \"detail\": \"address\",\n            \"type\": \"avs\"\n        }\n    ],\n    \"paymentInstrument\": {\n        \"type\": \"card/network+masked\",\n        \"card\": {\n            \"number\": {\n                \"bin\": \"444433\",\n                \"last4Digits\": \"1111\"\n            },\n            \"countryCode\": \"GB\",\n            \"brand\": \"visa\",\n            \"fundingType\": \"debit\",\n            \"issuer\": {\n                \"name\": \"VALID_ISSUER\"\n            },\n            \"paymentAccountReference\": \"somePAR\"\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/v6/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":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next steps"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Take a subsequent ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/card-payments/v6/authorise-a-recurring-payment#recurring-payment-request"},"children":["recurring payment with the token"]}," you have received in your ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#card-on-file-response"},"children":["card on file response"]},"."]}]},"headings":[{"value":"Repeat Wallet Payments","id":"repeat-wallet-payments","depth":1},{"value":"What are card on file payments?","id":"what-are-card-on-file-payments","depth":3},{"value":"Card on file authorization request","id":"card-on-file-authorization-request","depth":2},{"value":"Card on file authorization example request:","id":"card-on-file-authorization-example-request","depth":3},{"value":"Descriptions of your authorization request parameters","id":"descriptions-of-your-authorization-request-parameters","depth":4},{"value":"Optional parameters","id":"optional-parameters","depth":4},{"value":"Full authorization request body:","id":"full-authorization-request-body","depth":4},{"value":"Card on file response","id":"card-on-file-response","depth":2},{"value":"Successful response","id":"successful-response","depth":3},{"value":"Refused response","id":"refused-response","depth":3},{"value":"Example response","id":"example-response","depth":4}],"frontmatter":{"seo":{"title":"Repeat Wallet Payments"}},"lastModified":"2026-05-13T07:59:15.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/card-payments/v6/repeatwallets","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}