{"templateId":"markdown","versions":[{"version":"v1","label":"v1 (latest)","link":"/products/hosted-payment-pages/configuration","default":true,"active":true,"folderId":"089b7d23"}],"sharedDataIds":{"sidebar":"sidebar-products/hosted-payment-pages/sidebars.yaml","current-catalog-info":"current-catalog-info-/products/hosted-payment-pages/openapi"},"props":{"metadata":{"markdoc":{"tagList":["partial","badge","admonition"]},"custom_product":"Hosted Payment Pages","type":"markdown"},"seo":{"title":"Configure your payment page","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"]},": 14 June 2025 | ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-payment-pages/changelog/"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Change log"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"configure-your-payment-page","__idx":0},"children":["Configure your payment page"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"Badge","attributes":{"size":"small","fontWeight":"bold","color":"var(--wp-colour-black)","mt":"0rem","mb":"0.5rem","px":"1rem","py":"0.5rem","borderRadius":"6rem","bg":"#A5EFFF"},"children":["SMB (Worldpay eCommerce)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can customize your payment page by:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["selecting the relevant channel from the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["\"Channel\""]}," dropdown in the top navigation"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["adjusting properties for payment methods and payment page"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["personalizing your merchant settings"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["previewing your changes"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Channels are a set of customizations that you can use to customize different payment pages with specific requirements. We provide a \"Default\" channel for your payment page but you can also create new channels to customize the payment page for different business verticals and events."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"create--a-channel","__idx":1},"children":["Create  a channel"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can create a new channel to apply a required set of customizations to the payment page."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When logging into the Payment Page Designer for the first time, you will see the 'Default' channel in the 'Channel' dropdown menu. To add a new channel:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start writing the name of the new channel in the 'Channel' dropdown textbox"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/access/assets/defaultchannel.567c65ea9c64ac8f9a1f7e7deee0ef37a21389680bf81e62af9b068917832fa8.de4c3ec0.jpg","alt":"Channel dropdown textbox screenshot"},"children":[]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click 'Add' to create the new channel"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click 'Add' in the pop-up window below to confirm your action"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/access/assets/addchannel.8d1cbfe8dd5265bba1cf67ef4e7e69e82655a77cfbe2b12ba580abf30b543ea4.de4c3ec0.jpg","alt":"Add a new channel screenshot"},"children":[]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"select-channel","__idx":2},"children":["Select channel"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To utilize the customization you have configured for the created channel, simply choose the desired channel from the 'Channel' dropdown menu. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-payment-pages/setup-a-payment#optionalconditional-parameters"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["customisation_id"]}]}," is displayed next to the dropdown."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/access/assets/customisationid.0ebda942239ee29aa2fd9d917cd419479fced2905917424570ab52a91332d877.de4c3ec0.jpg","alt":"Channel dropdown customization ID screenshot"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuration-options","__idx":3},"children":["Configuration options"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To make changes to your payment page, expand the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Configuration"]}," menu where you will find three options to choose from:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Payment Method"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Payment Page"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Merchant"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Opening these sections reveals the following properties:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"edit-payment-method-configuration","__idx":4},"children":["Edit \"Payment Method\" configuration"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"cards","__idx":5},"children":["Cards"]},{"$$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":"UI element"},"children":["UI element"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show card icons"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["toggle"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["on"]},", logos for card payments are displayed.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},"You may want to hide the card icons if you are displaying the payment pages in an iframe and you already provide the card types in your own website."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle off (false)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show cardholder name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["toggle"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["on"]},", the cardholder name is displayed above their payment details.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," You may want to hide this if the customer's name is already displayed elsewhere on your payment page.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Info"},"children":["If set to false, you must provide the cardholder name in the billing address, and it must contain at least one of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<firstName>"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<lastName>"]},"."]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle on (true)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show payment details header"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["toggle"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["on"]},", the payment header is displayed.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," You may want to hide this to reduce the frame size or to complement your aesthetic."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle on (true)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Mask card details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["toggle"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["on"]},", the card and CVC number are hidden as they are typed."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle off (false)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Shipping Address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Displays the shipping address of the customer on the payment pages. The dropdown has the following options :",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Hide"]}," - Hide shipping address"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show"]}," - Show shipping address"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Edit"]}," - Allow customers to show and edit shipping address."]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Hide"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Billing Address"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Displays the billing address of the customer on the payment pages. Dropdown have following options :",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Hide"]}," - Hide billing address"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show"]}," - Show billing address"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Edit"]},"  Allow customers to show and edit billing address."]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Edit"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Contact Details"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Displays the contact details of the customer on the payment pages. Dropdown have following options :",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Hide"]}," - Hide contact details"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show"]}," - Show contact details"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Edit"]}," - Allow customers to show and edit contact details."]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Hide"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Change Payment Button Text"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Customize the text displayed on the ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Make Payment"]}," button with a variety of alternatives available through a drop-down menu:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Submit Payment"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Buy Now"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Pay Now"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Save account"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Save card"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Save"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Add"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Add card"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Book now"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Continue"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Place Order"]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Make payment"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"wallets","__idx":6},"children":["Wallets"]},{"$$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":"Wallet"},"children":["Wallet"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"UI element"},"children":["UI element"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Google Pay"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Button Colour"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Change the color displayed on the Google Pay button through a drop-down menu:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Black"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["White"]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Black"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Button Label"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Change the text displayed on the Google Pay button through a drop-down menu:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Buy with G Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["G Pay"]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Buy with G Pay"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Apple Pay"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Button Colour"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Change the color displayed on the Apple Pay button through a drop-down menu:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Black"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["White"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["White with outline"]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Black"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Button Label"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Change the text displayed on the Apple Pay button through a drop-down menu:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Book with Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Buy with Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Check out with Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Donate with Apple Pay"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Set up with Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Subscribe with Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Add money with Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Contribute with Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Order with Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Reload with Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Rent with Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Support with Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Tip with Apple Pay"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Top Up with Apple Pay"]}]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Apple Pay"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/access/assets/paymentmethod.2a05f78f795138f25c00204605fc82703484c6339bbc73dabe6a889b28b9944b.de4c3ec0.jpg","alt":"Payment Method Configuration screenshot"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"edit-payment-page-configuration","__idx":7},"children":["Edit \"Payment Page\" configuration"]},{"$$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":"UI element"},"children":["UI element"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Default"},"children":["Default"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show country list"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["toggle"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["on"]},", displays a drop-down list of countries on the payment pages."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle off (false)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show language list"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["toggle"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["on"]},", displays a drop-down list of languages on the payment pages."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle off (false"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show cancel button"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["toggle"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["on"]},", the cancel button lets the customer cancel the payment."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle on (true)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show Powered by Worldpay"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The \"Powered by Worldpay\" logo (referring to \"worldpay\" on the payment pages) is displayed while content is being displayed on a payment page."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle on (true))"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show page footer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["toggle"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["on"]},", Worldpay copyright information is displayed in the footer."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle on (true)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show page header and logo"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["toggle"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["on"]},", we display the selected logo and associated space around the logo."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle on (true)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Show change payment method button"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Returns the customer to the payment method selection page."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle on (true) ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," The ",{"$$mdtype":"Tag","name":"b","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Change payment method"]}]}," button is displayed.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Info"},"children":[" A back button may be displayed instead of a change payment method button."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/access/assets/paymentpage.6a4524aa509e6ed2a4f9bc9ddfd0254539f866a84e3017af95f3236d698986ae.de4c3ec0.jpg","alt":"Payment Page Configuration screenshot"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"edit-merchant-configuration","__idx":8},"children":["Edit \"Merchant\" configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Customize settings about the parameters that you send and receive from us."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["During the payment process, you can optionally append parameters to one or both of the following URLs:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redirect URL:"]},{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","Once we receive your initial order, we send a response containing a redirect URL. You use this to redirect your customer to the payment pages."," ","You can optionally append our standard parameters or your own custom parameters to the redirect URL."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Result URL:"]}," ",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," ","When we receive the payment result, we redirect your customer to a result page. We recommend that you provide us with your custom result URLs."]}]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type of redirect"},"children":["Type of redirect"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Gateway default"},"children":["Gateway default"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Disable strict redirect URLs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["result URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When we return the customer to your website with the payment result URL, we may append additional parameters to the query-string. When we construct the URL, we append the fragment after query string: ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" when set to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["true"]},", we append the additional information after the fragment"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" when set to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["false"]},", we append the additional information before the fragment. This means that the additional information is placed between the URL and the fragment"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle on (true)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return error reasons in URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["result URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When this feature is enabled, and there's a problem processing a payment on the payment pages, we can return additional information on the query-string of your result URL: ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["errorRefNumber - a unique identifier for the issue, which can be passed to support teams"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["messages - a comma-separated list of error message as to why the payment could not be processed"]}]}," Dropdown options: ",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" when set to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["true"]},", we append the additional error messages"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[" when set to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["false"]},", we won't append additional error messages"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Toggle on (true)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Whitelist redirect URLs"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["result URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This allows you to whitelist redirect URLs. You can use this to redirect your customer to a sites that don't necessarily start with \"http/https\"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No default.",{"$$mdtype":"Tag","name":"br","attributes":{},"children":[]}," Whitelist one or more URL(s)."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/access/assets/merchantconfig.342fdfe3c31b04036e302e92812392d503f9c02b7bb2c3a9dc04b5d4bc56d838.de4c3ec0.jpg","alt":"merchant configuration screenshot"},"children":[]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"preview-the-changes","__idx":9},"children":["Preview the changes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The preview window on the right-hand side allows you to see how your customization appear on the page."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only the card capture page is visible. The preview doesn't currently reflect all account configurations and payment page properties. You can use it as a visual guide to see how your logo and stylesheet (CSS) have been rendered on the page."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Best practice"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We strongly recommend you complete sufficient testing in Try before publishing to production. For more information see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/products/hosted-payment-pages/test-designs"},"children":["test and publish designs"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/access/assets/preview.00a01c16c04a56458e22d39405188b18b1bdf77da7fd7dfc6f1e490c5723339d.de4c3ec0.jpg","alt":"Order summary page screenshot"},"children":[]}]}]},"headings":[{"value":"Configure your payment page","id":"configure-your-payment-page","depth":1},{"value":"Create  a channel","id":"create--a-channel","depth":2},{"value":"Select channel","id":"select-channel","depth":3},{"value":"Configuration options","id":"configuration-options","depth":2},{"value":"Edit \"Payment Method\" configuration","id":"edit-payment-method-configuration","depth":3},{"value":"Cards","id":"cards","depth":4},{"value":"Wallets","id":"wallets","depth":4},{"value":"Edit \"Payment Page\" configuration","id":"edit-payment-page-configuration","depth":3},{"value":"Edit \"Merchant\" configuration","id":"edit-merchant-configuration","depth":3},{"value":"Preview the changes","id":"preview-the-changes","depth":2}],"frontmatter":{"seo":{"title":"Configure your payment page"}},"lastModified":"2026-06-04T15:48:50.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/hosted-payment-pages/configuration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}