{"data":{"id":"payment-form/add-digital-wallets/masterpass","type":"route","relationships":{"page":{"data":{"id":"4vXFLZiEekx8TSwKB60kR5","type":"doc-page"}}}},"included":[{"id":"77LtiJD967Bha2c6oqIEGU","type":"markdown-block","attributes":{"name":"REUSABLE CONTENT: Payment form deprecation warning","markdown":"!!!warning\nThe Square payment form is deprecated. Use the [Web Payments SDK](/web-payments/overview) to take payments on a web client.\n!!!\n","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[]}}},{"id":"REUSE_BLOCK_FIND_LOCATION_INTRO","type":"constant","attributes":{"value":"To see a cURL example showing how to get a specific location, see the [Retrieve a specific location](locations-api#retrievelocation) code example. To get started quickly:\n\n1. Go to the **Locations** page of your Square application in the Developer Dashboard.\n2. Copy the ID of the location you want to use."}},{"id":"INFO_YOU_NEED","type":"constant","attributes":{"value":"To use the steps in this topic, you need:"}},{"id":"INFO_LOCATION_ID","type":"constant","attributes":{"value":"**An active location ID.** Copy a developer account location ID from the **Locations** page of your Square application in the Developer Dashboard or set the Developer Dashboard to **Sandbox** mode and then copy a Sandbox location ID."}},{"id":"INFO_APP_ID","type":"constant","attributes":{"value":"**Your application ID.** Find your application ID on the **Credentials** page of your Square application in the Developer Dashboard."}},{"id":"INFO_APP_SECRET","type":"constant","attributes":{"value":"**Your application secret**. Find (or replace) your application secret on the **OAuth** page of your Square application in the Developer Dashboard."}},{"id":"INFO_ACCESS_TOKEN","type":"constant","attributes":{"value":"**A valid access token.** You should test with Sandbox credentials whenever possible. For more information, see [Square API Access Tokens.](/build-basics/access-tokens)"}},{"id":"PREREQ_ACTIVE_ACCOUNT","type":"constant","attributes":{"value":"You have a Square account enabled for payment processing. If you have not\nenabled payment processing on your account (or you are not sure), visit\n[squareup.com/activate](${ACTIVATE_ACCOUNT})."}},{"id":"PREREQ_SQUARE_ACCOUNT","type":"constant","attributes":{"value":"**You have a valid Square account**. To create a Square account in minutes, visit [squareup.com/signup](https://{{SQUARE_DOMAIN}}/signup?v=developers)."}},{"id":"PREREQ_HTTPS","type":"constant","attributes":{"value":"**You are using HTTPS.** HTTPS is required for all production Square API calls. HTTP calls are only supported for developing and testing on localhost. "}},{"id":"LIMIT_NO_SANDBOX","type":"constant","attributes":{"value":"Testing support is not available in the current Square Sandbox."}},{"id":"ASSUME_IOS","type":"constant","attributes":{"value":"You are generally familiar with developing applications on iOS. If you are new to iOS development, you should visit the [Apple Training Center](https://training.apple.com/us/en) before continuing."}},{"id":"ASSUME_ANDROID","type":"constant","attributes":{"value":"You are generally familiar with developing applications on Android. If you are new to Android development, you should read the [Getting Started Guide](https://developer.android.com/training/index.html) on the Android Developers site before continuing."}},{"id":"ASSUME_LOCALHOST","type":"constant","attributes":{"value":"You can create and run websites on localhost or a development server. If you are new to testing web pages locally, you should read [Run Local Web Servers](/testing/local-web-server) before continuing."}},{"id":"ASSUME_WEB_DEV","type":"constant","attributes":{"value":"You are familiar with basic web development. If you are new to web development, you should read [Getting started with the Web\n](https://developer.mozilla.org/en-US/docs/Learn/Getting_started_with_the_web) by Mozilla.org before continuing."}},{"id":"ASSUME_BACKEND","type":"constant","attributes":{"value":"You have a payment processing backend available for testing. If you need help setting up a basic server, follow the directions in the [Creating a testing backend](/testing/heroku-test-service) guide to create a simple Heroku service."}},{"id":"ASSUME_PRODUCT","type":"constant","attributes":{"value":"You have read the introductory review of this API. "}},{"id":"BUY_SQUARE_READER_TIP","type":"constant","attributes":{"value":"!!!tip\nIf you do not have a Square Reader, you can request a [free Magstripe Reader](${FREE_MAGSTRIPE_READER}) or purchase a Square Reader [online](${BUY_SQUARE_READER}) or [in person](${BUY_SQUARE_READER_IN_PERSON}).\n!!!"}},{"id":"COF_ASK_PERMISSION","type":"constant","attributes":{"value":"!!!important\nAlways ask customers for permission before saving their card information. For example, include a checkbox in your purchase flow that customers can select to specify that they want to save their card information for future purchases.\n\nLinking cards on file without obtaining customer permission can result in your application being disabled without notice.\n!!!"}},{"id":"CONFIG_FILE_TIP","type":"constant","attributes":{"value":"!!!tip\nYou can create a [Square config file](build-basics/connect-config-file) to capture useful constants and helper functions. A config file is not required to work with Square APIs and SDKs, but it makes using the example code easier.\n!!!"}},{"id":"INFO_READER_SDK_REPO_PASSWORD","type":"constant","attributes":{"value":"**Your Reader SDK repository password.** Find your Reader SDK repository password on the **Reader SDK** page of your Square application in the Developer Dashboard."}},{"id":"EXPAND_WITH_RECIPES","type":"constant","attributes":{"value":"Now that you have a basic build in place, expand on it with these recipes!"}},{"id":"ASSUME_CONFIG_FILE","type":"constant","attributes":{"value":"You are using a [Connect API config file](/build-basics/connect-config-file)."}},{"id":"GET_APPID_LOCATIONID_WITH_ANIMATION","type":"constant","attributes":{"value":"Get your sandbox application credentials from the Square Developer Dashboard. Use the Square Sandbox environment for testing so that you do not charge your real credit card. \n\n 1. Open the [Developer Dashboard](${APP_DASHBOARD}). \n\n 2. Choose the application you want to use in the sandbox. If you do not have an application, [create one](${APP_DASHBOARD}/new). The application provides the credentials you need. \n\n 3. Choose **Credentials** on the left navigation pane. \n\n ![An animation showing how to get Sandbox application credentials from the Developer Dashboard.](//images.ctfassets.net/1nw4q0oohfju/1r9ndy1prLwK38KFpmdLc2/1cfe1e8091bd620880cd3abe012980c9/sandbox-app-credentials.gif)\n\n 4. Make a note of the following values: **Sandbox Application ID** and **Sandbox Access Token**.\n 4. On the **Locations page**, choose a location ID to use in the first step of integration.\n\n ![A graphic showing the Sandbox Locations page, where you choose a location ID.](//images.ctfassets.net/1nw4q0oohfju/3BBAZ1K9SZuehgM8vRVynr/c004214d5f8e581daddbab5442fc30d1/sandbox-locations-page.png)\n"}},{"id":"ASSUME_PAYMENTFORM_INTEGRATION","type":"constant","attributes":{"value":"* You have [integrated the payment form](payment-form/payment-form-walkthrough) into your web application.\n\n"}},{"id":"IAP_DIGITAL_WARNING","type":"constant","attributes":{"value":"!!!important\nWhile the In-App Payments SDK supports payments for physical and digital sales, using the In-App Payments SDK to process digital sales might not be allowed by some mobile application distribution services (such as App Store and Google Play) and might result in your application being removed. Examples of digital sales include intangible goods (such as,in-game assets), online services (such as upgrades in application functionality), and digital subscriptions (such as cloud or streaming services).\n\nTo avoid the potential removal from application distribution platforms, the In-App Payments SDK should only be used to process sales of goods or services that are consumed outside the application. You should review the terms of service for the respective mobile application distribution services you use to ensure that you are compliant with their guidelines.\n!!!"}},{"id":"INFO_SANDBOX_APP_ID","type":"constant","attributes":{"value":"**Your Sandbox application ID**. Enable **Sandbox Settings** mode and find your Sandbox application ID on the **Credentials** page of your Square application in the Developer Dashboard."}},{"id":"SQUARE_SANDBOX","type":"constant","attributes":{"value":"Sandbox"}},{"id":"LOG_IN_AND_VIEW_SANDBOX_DASHBOARD","type":"constant","attributes":{"value":"[sign in](${SQUARE_LOGIN}?app=developer&return_to=${DOCS_URL_ROOT}/in-app-payments-sdk/quick-start/step-3) to your Square account and view the payment details in the Square Sandbox [Seller Dashboard](https://squareupsandbox.com/dashboard/sales/transactions)."}},{"id":"LOG_IN_AND_RETURN_TO_DOCPAGE","type":"constant","attributes":{"value":"[log in](${SQUARE_LOGIN}?app=developer&return_to=${DOCS_URL_ROOT}"}},{"id":"GET_HELP","type":"constant","attributes":{"value":"[contact Developer Support](https://{{SQUARE_DOMAIN}}/help/contact?panel=BF53A9C8EF68), [join our Slack](https://squ.re/2Hks3YE), or reach out to your Square Account Manager."}},{"id":"PREREQ_SANDBOX_SDK","type":"constant","attributes":{"value":"To use Square SDKs with the new Sandbox, set the API client base path to `https://connect.squareupsandbox.com`. Refer to the SDK README on GitHub for additional information."}},{"id":"PREREQ_SANDBOX_CURL","type":"constant","attributes":{"value":"To call the Square Sandbox with cURL or REST, use `connect.squareupsandbox.com` as the target domain. For more information, see [Testing with Sandbox](/testing/sandbox)."}},{"id":"GRN_CHK","type":"constant","attributes":{"value":"✅"}},{"id":"V2_WEBHOOK","type":"constant","attributes":{"value":"Webhooks"}},{"id":"API_EXPLORER","type":"constant","attributes":{"value":"Square API Explorer (beta)"}},{"id":"DISPUTES_TEST_VALUES","type":"constant","attributes":{"value":" |Charge amount | Dispute reason |\n |:-------------|:-----------------------|\n |8801 |AMOUNT_DIFFERS |\n |8802 |CANCELLED |\n |8803 |DUPLICATE |\n |8804 |NO_KNOWLEDGE |\n |8805 |NOT_AS_DESCRIBED |\n |8806 |NOT_RECEIVED |\n |8807 |PAID_BY_OTHER_MEANS |\n |8808 |CUSTOMER_REQUESTS_CREDIT|\n |8809 |EMV_LIABILITY_SHIFT |\n "}},{"id":"DEPRECATION_TABLE","type":"constant","attributes":{"value":"### Deprecated\nThe following endpoints are currently deprecated and scheduled to be retired as noted. \n|

Collection

Replacements

Deprecation

Retirement

|\n|:--------------------------|:----------------------------------------------------------------------------------------------------|:----------|:----------|\n|V2 Employees |[Team API](${SQUARE_TECH_REF}/team-api)
[Migration guide](/team/migrate-from-v2-employees) |2020-08-26 |2021-09-15|\n|V2 Transactions |[Payments API](${SQUARE_TECH_REF}/payments-api)
[Migration guide](/payments-api/migrate-from-transactions-api) |2019-08-15 |TBD|\n\n### Retired\nThe following endpoints have been retired and are no longer supported by documentation. If you have not migrated your code to use Square API endpoints, refer to the migration guides in the table to learn about the needed migrations.\n|

Collection

Replacements

Deprecation

Retirement

|\n|:--------------------------|:----------------------------------------------------------------------------------------------------|:----------|:----------|\n|V1 Employees.Employees |[Team API](${SQUARE_TECH_REF}/team-api)
[Migration guide](/migrate-from-v1/guides/v1-employees) |2020-08-26 |2021-09-15 |\n|V1 Employees.EmployeeRoles |[Team API](${SQUARE_TECH_REF}/team-api)
[Migration guide](/migrate-from-v1/guides/v1-employees) |2020-08-26 |2021-09-15 |\n|V1 Employees.Timecards |[Labor API](${SQUARE_TECH_REF}/labor-api)
[Migration guide](/migrate-from-v1/guides/v1-timecards) |2020-02-26 |2021-02-26 |\n|V1 Employees.CashDrawers |[Cash Drawers API](${SQUARE_TECH_REF}/cash-drawers-api)
[Migration guide](/migrate-from-v1/guides/v1-cashdrawershifts)|2020-02-26|2021-02-26 |\n|V1Items |[Catalog API](${SQUARE_TECH_REF}/catalog-api)
[Inventory API](${SQUARE_TECH_REF}/inventory-api)
[Migration guide](/migrate-from-v1/guides/v1-items)|2019-11-20|2021-02-26|\n|V1 Locations |[Locations API](${SQUARE_TECH_REF}/locations-api)
[Migration guide](/migrate-from-v1/guides/v1-locations)|2019-11-20 |2020-11-18 | \n|V1 Transactions.BankAccounts|[Bank Accounts API](${SQUARE_TECH_REF}/bank-account-api)
[Migration guide](/migrate-from-v1/guides/v1-bankaccounts) |2020-02-26 |2021-02-26|\n|V2 Reporting |[Payments API](${SQUARE_TECH_REF}/payments-api)
[Migration guide](/payments-api/migrate-from-transactions-api) |2019-08-15 |2020-08-26|\n\n### Work in progress\nThe following endpoints will be deprecated when corresponding functionality is available in the Square API.\n\n|

Collection

Replacements

Deprecation

Retirement

|\n|:--------------------------|:----------------------------------------------------------------------------------------------------|:----------|:----------|\n|V1 Batching |Various
[Migration guide](/migrate-from-v1/general-guidance#batching) |2019-11-20 |TBD | \n|V1 Transactions.Payments |pending |TBD |TBD |\n|V1 Transactions.Refunds |pending |TBD |TBD |\n|V1 Transactions.Settlements|pending |TBD |TBD |\n"}},{"id":"LOYALTY_SANDBOX_PHONE","type":"constant","attributes":{"value":"You test the sample walkthrough in the Square Sandbox environment. After creating a loyalty program, you need a phone number to set up a loyalty account. In the Sandbox, you provide a Sandbox phone number, instead of a real phone number, using the following format:\n\n```\n+1555\n```\n\nFor example, +14255551111.\n"}},{"id":"MASTERPASS_LONG","type":"constant","attributes":{"value":"Masterpass (now Mastercard Click to Pay)"}},{"id":"MASTERPASS","type":"constant","attributes":{"value":"Secure Remote Commerce"}},{"id":"MASTERPASS_SRC","type":"constant","attributes":{"value":"!!!info\nThe names of `SqPaymentForm` ${MASTERPASS} (SRC) objects have not changed from the original Masterpass to minimize the amount of recoding that you must do to support SRC.\n!!!"}},{"id":"TERMINAL_CHECKOUT","type":"constant","attributes":{"value":"Terminal API"}},{"id":"TERMINAL_REFUND","type":"constant","attributes":{"value":"Terminal API"}},{"id":"SQUARE_ONLINE_EAP","type":"constant","attributes":{"value":"!!!\nSquare Online APIs are publicly available as part of an early access program. For more information, see [Early access program for Square Online APIs.](/online-api#early-access-program-for-square-online-apis)\n!!!"}},{"id":"LOYALTY_WALKTHROUGH_SETUP_NOTE_AVAILABILITY","type":"constant","attributes":{"value":" !!!info\n These steps assume that you are setting up a loyalty program for the first time. To change an existing program, in the navigation pane, choose **Loyalty**, choose **Settings**, and then edit the **Earning Points** and **Redeeming Rewards** settings to match the settings described in this topic.\n\n The **Loyalty** page is available only if your Square account is activated in a [supported country,](/loyalty-api/overview#loyalty-market-availability) or if you open the Seller Dashboard with a [test account](/testing/create-and-authorize-sandbox-account) configured for a supported country. Custom test accounts use an OAuth access token instead of the Sandbox access token, so you must grant the account the [required permissions](/oauth-api/square-permissions) for the Square APIs used in this walkthrough. \n !!!"}},{"id":"CUSTOMER_ASSIGNMENTS_FOR_ORDERS_AND_PAYMENTS","type":"constant","attributes":{"value":"In the Seller Dashboard, transaction activity is based on the `customer_id` of the order and other related settings, but the `customer_id` of the payment is ignored. For example, if the order does not have a customer assignment, the transaction's **Paid by** field might not display the customer who is assigned to the payment. To reliably link transactions to customers in the Seller Dashboard, make sure to specify the `customer_id` field in your `CreateOrder` request. \n\nIn addition, omitting this field on the `Order` object might result in the creation of new [instant profiles](/customers-api/what-it-does?preview=true#instant-profiles) that are linked to the payment."}},{"id":"LOYALTY_TAX_ACCRUAL_LOGIC","type":"constant","attributes":{"value":"!!!info\nThe country of the seller's Square account determines whether tax is included in the purchase amount by default when accruing points. This accrual logic applies to amount-spent programs and visit-based programs that have a minimum spend requirement. For more information, see [Availability of Square Loyalty.](/loyalty-api/overview#loyalty-market-availability)\n!!!"}},{"id":"GIFT_CARD_ACTIVATE_OR_LOAD_ORDER_REQ","type":"constant","attributes":{"value":"If your application uses the Orders API to process gift card orders, the order must be in the `COMPLETED` state before you can use it to activate or load a gift card. In addition, the line item for the gift card must specify `GIFT_CARD` as the `item_type`. Otherwise, the order is not processed as a gift card sale and the gift card cannot be activated or loaded using Orders API integration."}},{"id":"WALKTHROUGH_GATHER_ACCOUNT_INFO","type":"constant","attributes":{"value":"Follow these steps to get the access token and location ID used in this walkthrough.\n\n1. Sign in to the [Developer Dashboard](${APP_DASHBOARD}). If you do not have a Square account, see [Get Started](/get-started) to learn how to create an account and an application. \n2. Open your application.\n3. Get your Sandbox access token: \n 1. At the top of the page, in the **Sandbox** and **Production** toggle, choose **Sandbox**. \n 2. On the **Credentials** page, under **Sandbox Access Token**, choose **Show** and then copy the token. All Square API requests require an access token for authorization. This [personal access token](/build-basics/access-tokens) grants full access to the Sandbox resources in your account. \n\n ${SECURE_SANDBOX_ACCESS_TOKEN}\n\n4. Get your location ID: \n 1. In the navigation pane, choose **Locations**. \n 2. On the **Locations** page, keep **Default Test Account** selected and copy a location ID."}},{"id":"GIFT_CARD_PHYSICAL_CARD_IN_SANDBOX","type":"constant","attributes":{"value":"!!!info\nThis walkthrough creates a digital gift card in the Sandbox. Although testing physical gift cards is not supported in the Sandbox, you can [register and activate physical gift cards](/gift-cards/using-gift-cards-api#selling-square-gift-cards) in the production environment using the process described in this walkthrough.\n!!!"}},{"id":"SECURE_SANDBOX_ACCESS_TOKEN","type":"constant","attributes":{"value":"!!!important\nThe Sandbox access token is a secure secret. Do not share it with anyone.\n!!!"}},{"id":"MD_BLOCKS","type":"constant-set","relationships":{"constants":{"data":[{"id":"REUSE_BLOCK_FIND_LOCATION_INTRO","type":"constant"},{"id":"INFO_YOU_NEED","type":"constant"},{"id":"INFO_LOCATION_ID","type":"constant"},{"id":"INFO_APP_ID","type":"constant"},{"id":"INFO_APP_SECRET","type":"constant"},{"id":"INFO_ACCESS_TOKEN","type":"constant"},{"id":"PREREQ_ACTIVE_ACCOUNT","type":"constant"},{"id":"PREREQ_SQUARE_ACCOUNT","type":"constant"},{"id":"PREREQ_HTTPS","type":"constant"},{"id":"LIMIT_NO_SANDBOX","type":"constant"},{"id":"ASSUME_IOS","type":"constant"},{"id":"ASSUME_ANDROID","type":"constant"},{"id":"ASSUME_LOCALHOST","type":"constant"},{"id":"ASSUME_WEB_DEV","type":"constant"},{"id":"ASSUME_BACKEND","type":"constant"},{"id":"ASSUME_PRODUCT","type":"constant"},{"id":"BUY_SQUARE_READER_TIP","type":"constant"},{"id":"COF_ASK_PERMISSION","type":"constant"},{"id":"CONFIG_FILE_TIP","type":"constant"},{"id":"INFO_READER_SDK_REPO_PASSWORD","type":"constant"},{"id":"EXPAND_WITH_RECIPES","type":"constant"},{"id":"ASSUME_CONFIG_FILE","type":"constant"},{"id":"GET_APPID_LOCATIONID_WITH_ANIMATION","type":"constant"},{"id":"ASSUME_PAYMENTFORM_INTEGRATION","type":"constant"},{"id":"IAP_DIGITAL_WARNING","type":"constant"},{"id":"INFO_SANDBOX_APP_ID","type":"constant"},{"id":"SQUARE_SANDBOX","type":"constant"},{"id":"LOG_IN_AND_VIEW_SANDBOX_DASHBOARD","type":"constant"},{"id":"LOG_IN_AND_RETURN_TO_DOCPAGE","type":"constant"},{"id":"GET_HELP","type":"constant"},{"id":"PREREQ_SANDBOX_SDK","type":"constant"},{"id":"PREREQ_SANDBOX_CURL","type":"constant"},{"id":"GRN_CHK","type":"constant"},{"id":"V2_WEBHOOK","type":"constant"},{"id":"API_EXPLORER","type":"constant"},{"id":"DISPUTES_TEST_VALUES","type":"constant"},{"id":"DEPRECATION_TABLE","type":"constant"},{"id":"LOYALTY_SANDBOX_PHONE","type":"constant"},{"id":"MASTERPASS_LONG","type":"constant"},{"id":"MASTERPASS","type":"constant"},{"id":"MASTERPASS_SRC","type":"constant"},{"id":"TERMINAL_CHECKOUT","type":"constant"},{"id":"TERMINAL_REFUND","type":"constant"},{"id":"SQUARE_ONLINE_EAP","type":"constant"},{"id":"LOYALTY_WALKTHROUGH_SETUP_NOTE_AVAILABILITY","type":"constant"},{"id":"CUSTOMER_ASSIGNMENTS_FOR_ORDERS_AND_PAYMENTS","type":"constant"},{"id":"LOYALTY_TAX_ACCRUAL_LOGIC","type":"constant"},{"id":"GIFT_CARD_ACTIVATE_OR_LOAD_ORDER_REQ","type":"constant"},{"id":"WALKTHROUGH_GATHER_ACCOUNT_INFO","type":"constant"},{"id":"GIFT_CARD_PHYSICAL_CARD_IN_SANDBOX","type":"constant"},{"id":"SECURE_SANDBOX_ACCESS_TOKEN","type":"constant"}]}}},{"id":"5DGFjDHv6huNzvmgQ5rjlw","type":"markdown-block","attributes":{"name":"payment-form : enable masterpass : intro","markdown":"This guide provides step-by-step instructions for enabling\n${MASTERPASS_LONG} with the Square payment form object (`SqPaymentForm`) using Secure Remote Commerce.\n\n{TOC depth=h3}\n\n${MASTERPASS_SRC}\n\nAfter completing the steps in this guide, your payment form includes a **Mastercard Click to pay** button like the following example:\n\n![A graphic showing the Secure Remote Commerce (Mastercard Click to Pay) button.](//images.ctfassets.net/1nw4q0oohfju/65vUHX0StDnQXPhvltFXP/a186e31adbfa9e40a616855b6310f8fd/Screen_Shot_2020-08-07_at_2.41.20_PM.png)\n\n## Migrate your existing Masterpass code\n\nThe ${MASTERPASS} background image is set by calling the [SqPaymentForm.masterpassImageUrl](${PAYMENT_FORM_TECH_REF}#masterpassimageurl) function.\n\nIf your application uses a CSS class property to set the ${MASTERPASS} button background image, you should migrate your application to use the `masterpassImageUrl` function. To migrate your code, complete [step 2](payment-form/add-digital-wallets/masterpass#step2) and [step 4.](payment-form/add-digital-wallets/masterpass#step4) ","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[{"id":"MD_BLOCKS","type":"constant-set"}]}}},{"id":"1ozaWmXh09AZfH7KQOuUDl","type":"markdown-block","attributes":{"name":"payment-form : digital wallets : enable masterpass : prereq&assump","markdown":"## Prerequisites and assumptions\n\nTo use ${MASTERPASS} with `SqPaymentForm`, the following must be true:\n\n* You are using HTTPS. SRC payments can be tested with `SqPaymentForm` on localhost without using HTTPS, but you must use HTTPS to accept payments in\n production.\n* ${MASTERPASS} is only available for Square accounts based in Canada, the United Kingdom, and the United States.\n\nThis guide also makes the following assumptions:\n\n* ${ASSUME_PRODUCT}\n* You have followed the required steps in the\n [Payment Form Setup Guide.](payment-form/build-the-form)\n This guide focuses specifically on customizing `SqPaymentForm` with ${MASTERPASS} and does not give instructions for the setup of `SqPaymentForm`.\n","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[]}}},{"id":"3wngGAs8upi9v9teTXPMWL","type":"markdown-block","attributes":{"name":"payment-form : add-digital-wallets : masterpass : step 1 (text)","markdown":"## Step 1: Add the ${MASTERPASS} placeholder to your payment page\n\nIf you are using the [payment form with digital wallet support](${CONNECT_EXAMPLES_GITHUB_URL}/templates/web-ui/payment-form/basic-digital-wallet) templates, the ${MASTERPASS} placeholder is included by default.\n","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[]}}},{"id":"4ee2ccSQstmu0wcP1lTfZE","type":"markdown-block","attributes":{"name":"payment-form : add-digital-wallets : masterpass : step 1 (text) : html","markdown":"```html copy_code\n\n```","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[]}}},{"id":"4gTciRSecaTgz3QpJwPGF2","type":"multi-language-block","relationships":{"blocks":{"data":[{"id":"4ee2ccSQstmu0wcP1lTfZE","type":"markdown-block"}]}}},{"id":"2eVWNF9Bh0q8ggI1mXjlCh","type":"markdown-block","attributes":{"name":"payment-form : add-digital-wallets : masterpass : step 2 (text)","markdown":"\n## Step 2: Customize the ${MASTERPASS} button size\n\nMastercard provides a range of image resources to choose from if you want to customize the ${MASTERPASS} button.\n\n\nAdd the `button-src` class to the mysqpaymentform.css file if it is not present.\n\n!!!info\nIf you are migrating your code to use the `masterpassImageUrl` function, remove the `background-image` property from the `button-masterpass` class.\n!!!\n","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[]}}},{"id":"k0sSXPoiFzxfHW2oU5YSx","type":"markdown-block","attributes":{"name":"payment-form : add-digital-wallets : masterpass : step 2 (code) : css","markdown":"```css copy_code\n/* Indicates how SRC button will appear */\n.button-src {\n min-width: 200px;\n min-height: 40px;\n max-height: 40px;\n padding: 0;\n margin: 10px;\n background-color: black;\n background-size: 100% 100%;\n background-repeat: no-repeat;\n background-position: 50% 50%;\n border-radius: 5px;\n border-color: rgb(255, 255, 255);\n cursor:pointer;\n display: none;\n}\n```","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[]}}},{"id":"7md9voIKD3CbCu1QGcLMfp","type":"multi-language-block","relationships":{"blocks":{"data":[{"id":"k0sSXPoiFzxfHW2oU5YSx","type":"markdown-block"}]}}},{"id":"1OTCjiVUMaBEFfPzxOaMFf","type":"markdown-block","attributes":{"name":"payment-form : add-digital-wallets : masterpass : step 3 (text) ","markdown":"## Step 3: Enable ${MASTERPASS} in the SqPaymentForm object\n\nEnable the ${MASTERPASS} parameter by initializing it with the HTML placeholder ID\nyou set in the previous step.\n\n If you are using the [payment form with digital wallet support](${CONNECT_EXAMPLES_GITHUB_URL}/templates/web-ui/payment-form/basic-digital-wallet/sqpaymentform-basic.js) template, the ${MASTERPASS}\n parameter is enabled by default. \n","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[]}}},{"id":"3ENQljbUtLlKdatAIIRHsg","type":"markdown-block","attributes":{"name":"payment-form : add-digital-wallets : masterpass : step 3 (code) : javascript","markdown":"```javascript copy_code\n// Create and initialize a payment form object\nvar paymentForm = new SqPaymentForm({\n\n ...\n\n // Initialize Masterpass placeholder ID\n masterpass: {\n elementId: 'sq-src'\n },\n\n ...\n});\n```","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[]}}},{"id":"wart7hBs1EeBJ8YJ5B3LL","type":"multi-language-block","relationships":{"blocks":{"data":[{"id":"3ENQljbUtLlKdatAIIRHsg","type":"markdown-block"}]}}},{"id":"4FBCr5yBY8o84ad5Squlnf","type":"markdown-block","attributes":{"name":"payment-form : add-digital-wallets : masterpass : step 4 (text)","markdown":"\n## Step 4: Update the methodsSupported callback function\n\n1. Make the ${MASTERPASS} button visible by adding code to set the `style.display` to `inline-block`.\n","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[]}}},{"id":"4aRvcbNXY75scy34auozFO","type":"markdown-block","attributes":{"name":"payment-form : add-digital-wallets : masterpass : step 4 (code) : javascript","markdown":"2. Set the background image URL of the ${MASTERPASS} button by setting the value of `masterpassBtn.style.backgroundImage` to the URL returned by the [masterpassImageUrl](${PAYMENT_FORM_TECH_REF}#masterpassimageurl) function. \n\n ```javascript copy_code\n\n methodsSupported(methods, unsupportedReason) {\n console.log(methods);\n const srcBtn = document.getElementById('sq-src');\n\n // Only show the button if src is enabled\n if (methods.masterpass === true) {\n srcBtn.style.display = 'inline-block';\n //Set button background image provided by the masterpassImageUrl function\n srcBtn.style.backgroundImage =`url(${paymentForm.masterpassImageUrl()})`\n } else {\n console.log(unsupportedReason);\n }\n },\n ```\n\n3. Delete the HTML for the visual placeholder (if it exists).\n\n ```html copy_code\n

SRC not enabled

\n ```","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[]}}},{"id":"13JiWk2vUNGHfR1xYMFiKu","type":"multi-language-block","relationships":{"blocks":{"data":[{"id":"4aRvcbNXY75scy34auozFO","type":"markdown-block"}]}}},{"id":"DEVELOPERS_URL_ROOT","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}"}},{"id":"SQUARE_URL_ROOT","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}"}},{"id":"DOCS_URL_ROOT","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/docs"}},{"id":"SQUARE_HELP_URL_ROOT","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/help"}},{"id":"SQUARE_LOGIN","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/login"}},{"id":"SQUARE_SIGNUP","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/signup?v=developers"}},{"id":"ACTIVATE_ACCOUNT","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/activate"}},{"id":"APP_DASHBOARD","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/apps"}},{"id":"SQUARE_DASHBOARD","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/dashboard"}},{"id":"CONNECT_TECH_REF","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/docs/api/connect/v2"}},{"id":"PAYMENT_FORM_TECH_REF","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/docs/api/paymentform"}},{"id":"AUTHZ_TECH_REF","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/docs/api/oauth"}},{"id":"READER_SDK_TECH_REF","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/docs/api/reader"}},{"id":"POS_API_TECH_REF","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/docs/api/point-of-sale"}},{"id":"IAP_TECH_REF","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/docs/api/in-app-payment"}},{"id":"PHP_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/square-php-sdk"}},{"id":"NODEJS_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/square-nodejs-sdk"}},{"id":"RUBY_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/square-ruby-sdk"}},{"id":"PYTHON_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/square-python-sdk"}},{"id":"JAVA_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/connect-java-sdk"}},{"id":"DOTNET_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/connect-csharp-sdk"}},{"id":"POS_ANDROID_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/point-of-sale-android-sdk"}},{"id":"POS_IOS_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/SquarePointOfSaleSDK-iOS"}},{"id":"IAP_IOS_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/in-app-payments-ios"}},{"id":"SQUARE_HELP_ACCEPTED_CARDS","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/help/article/5085"}},{"id":"SQUARE_HELP_CHARGEBACKS","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/help/article/5394"}},{"id":"SQUARE_HELP_CONTACT","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/help/contact?prefill=developer_api"}},{"id":"SQUARE_HELP_CONTACTLESS_READER","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/help/article/5639"}},{"id":"SQUARE_HELP_DEPOSIT_SCHEDULE","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/help/article/5438"}},{"id":"SQUARE_HELP_FEES","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/help/article/5068"}},{"id":"SQUARE_HELP_OFFLINE_MODE","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/help/article/5095"}},{"id":"SQUARE_HELP_POS_COF","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/help/article/5770"}},{"id":"SQUARE_HELP_PROCESS_REFUNDS","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/help/article/6116"}},{"id":"SQUARE_HELP_REFUND_OVERVIEW","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/help/article/5060"}},{"id":"SQUARE_HELP_SPLIT_TENDER","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/help/article/5097"}},{"id":"INSOMNIA_URL","type":"constant","attributes":{"value":"https://insomnia.rest"}},{"id":"PAW_URL","type":"constant","attributes":{"value":"https://paw.cloud"}},{"id":"POSTMAN_URL","type":"constant","attributes":{"value":"https://www.getpostman.com"}},{"id":"POSTMAN_BUTTON","type":"constant","attributes":{"value":"https://run.pstmn.io/button.svg"}},{"id":"POSTMAN_COLLECTION_URL","type":"constant","attributes":{"value":"https://app.getpostman.com/run-collection/5236465-5827b5b7-4b61-4003-8044-8fc0254dd547-SVYxovAy"}},{"id":"CONNECT_EXAMPLES_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/connect-api-examples/tree/master"}},{"id":"READER_SDK_RN_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/react-native-square-reader-sdk"}},{"id":"READER_SDK_FLUTTER_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/reader-sdk-flutter-plugin"}},{"id":"IAP_SDK_FLUTTER_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/in-app-payments-flutter-plugin"}},{"id":"IAP_SDK_REACT_NATIVE_PLUGIN_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/in-app-payments-react-native-plugin"}},{"id":"POS_ANDROID_SDK_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/point-of-sale-android-sdk"}},{"id":"POS_IOS_SDK_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/SquarePointOfSaleSDK-iOS"}},{"id":"BUY_SQUARE_READER","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/shop/hardware/products/chip-credit-card-reader-with-nfc"}},{"id":"FREE_MAGSTRIPE_READER","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/shop/hardware/products/free-credit-card-reader"}},{"id":"BUY_SQUARE_READER_IN_PERSON","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/where-to-buy"}},{"id":"MARKETPLACE_URL","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/us/en/app-marketplace"}},{"id":"IAP_SDK_FLUTTER_PLUGIN_GITHUB_URL","type":"constant","attributes":{"value":"https://github.com/square/in-app-payments-flutter-plugin"}},{"id":"SQUARE_GIFT_CARDS","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/gift-cards"}},{"id":"ANDROID_DEV_BASICS","type":"constant","attributes":{"value":"https://developer.android.com/training/basics"}},{"id":"ANDROID_DEV","type":"constant","attributes":{"value":"https://developer.android.com"}},{"id":"GITHUB_CONNECT_V2_EXAMPLES","type":"constant","attributes":{"value":"https://github.com/square/connect-api-examples/tree/master/connect-examples/v2"}},{"id":"GITHUB_CONNECT_V1_EXAMPLES","type":"constant","attributes":{"value":"https://github.com/square/connect-api-examples/tree/master/connect-examples/v1"}},{"id":"IAP_TECH_REF_ANDROID","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/docs/api/in-app-payment/android"}},{"id":"IAP_TECH_REF_IOS","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/docs/api/in-app-payment/ios"}},{"id":"SLACK_URL","type":"constant","attributes":{"value":"https://squ.re/2Hks3YE"}},{"id":"SQUARE_TECH_REF","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/reference/square"}},{"id":"OLD_TECH_REF","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/docs/api/connect/v2/2019-05-08"}},{"id":"NODEJS_SDK_TECH_REF_URL","type":"constant","attributes":{"value":"https://github.com/square/square-nodejs-sdk/blob/master/README.md"}},{"id":"PHP_SDK_TECH_REF_URL","type":"constant","attributes":{"value":"https://github.com/square/square-php-sdk/blob/master/README.md"}},{"id":"DOTNET_SDK_TECH_REF_URL","type":"constant","attributes":{"value":"https://github.com/square/square-dotnet-sdk/blob/master/README.md"}},{"id":"JAVA_SDK_TECH_REF_URL","type":"constant","attributes":{"value":"https://github.com/square/square-java-sdk/blob/master/README.md"}},{"id":"PYTHON_SDK_TECH_REF_URL","type":"constant","attributes":{"value":"https://github.com/square/square-python-sdk/blob/master/README.md"}},{"id":"RUBY_SDK_TECH_REF_URL","type":"constant","attributes":{"value":"https://github.com/square/square-ruby-sdk/blob/master/README.md"}},{"id":"TEST-CONSTANT","type":"constant","attributes":{"value":"some value2"}},{"id":"BUY_SQUARE_STAND","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/shop/hardware/products/ipad-pos-stand-credit-card-reader\n"}},{"id":"BUY_SQUARE_TERMINAL","type":"constant","attributes":{"value":"https://{{SQUARE_DOMAIN}}/shop/hardware/us/en/products/terminal-credit-card-machine"}},{"id":"API_EXPLORER_GA","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/explorer/square"}},{"id":"NODEJS_SDK_NAME","type":"constant","attributes":{"value":"Square Node.js SDK"}},{"id":"SQUARE_SDK_REF","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/reference/sdks"}},{"id":"SQUARE_TECH_ROOT","type":"constant","attributes":{"value":"https://developer.{{SQUARE_DOMAIN}}/reference"}},{"id":"DEVELOPERS_URLS","type":"constant-set","relationships":{"constants":{"data":[{"id":"DEVELOPERS_URL_ROOT","type":"constant"},{"id":"SQUARE_URL_ROOT","type":"constant"},{"id":"DOCS_URL_ROOT","type":"constant"},{"id":"SQUARE_HELP_URL_ROOT","type":"constant"},{"id":"SQUARE_LOGIN","type":"constant"},{"id":"SQUARE_SIGNUP","type":"constant"},{"id":"ACTIVATE_ACCOUNT","type":"constant"},{"id":"APP_DASHBOARD","type":"constant"},{"id":"SQUARE_DASHBOARD","type":"constant"},{"id":"CONNECT_TECH_REF","type":"constant"},{"id":"PAYMENT_FORM_TECH_REF","type":"constant"},{"id":"AUTHZ_TECH_REF","type":"constant"},{"id":"READER_SDK_TECH_REF","type":"constant"},{"id":"POS_API_TECH_REF","type":"constant"},{"id":"IAP_TECH_REF","type":"constant"},{"id":"PHP_GITHUB_URL","type":"constant"},{"id":"NODEJS_GITHUB_URL","type":"constant"},{"id":"RUBY_GITHUB_URL","type":"constant"},{"id":"PYTHON_GITHUB_URL","type":"constant"},{"id":"JAVA_GITHUB_URL","type":"constant"},{"id":"DOTNET_GITHUB_URL","type":"constant"},{"id":"POS_ANDROID_GITHUB_URL","type":"constant"},{"id":"POS_IOS_GITHUB_URL","type":"constant"},{"id":"IAP_IOS_GITHUB_URL","type":"constant"},{"id":"SQUARE_HELP_ACCEPTED_CARDS","type":"constant"},{"id":"SQUARE_HELP_CHARGEBACKS","type":"constant"},{"id":"SQUARE_HELP_CONTACT","type":"constant"},{"id":"SQUARE_HELP_CONTACTLESS_READER","type":"constant"},{"id":"SQUARE_HELP_DEPOSIT_SCHEDULE","type":"constant"},{"id":"SQUARE_HELP_FEES","type":"constant"},{"id":"SQUARE_HELP_OFFLINE_MODE","type":"constant"},{"id":"SQUARE_HELP_POS_COF","type":"constant"},{"id":"SQUARE_HELP_PROCESS_REFUNDS","type":"constant"},{"id":"SQUARE_HELP_REFUND_OVERVIEW","type":"constant"},{"id":"SQUARE_HELP_SPLIT_TENDER","type":"constant"},{"id":"INSOMNIA_URL","type":"constant"},{"id":"PAW_URL","type":"constant"},{"id":"POSTMAN_URL","type":"constant"},{"id":"POSTMAN_BUTTON","type":"constant"},{"id":"POSTMAN_COLLECTION_URL","type":"constant"},{"id":"CONNECT_EXAMPLES_GITHUB_URL","type":"constant"},{"id":"READER_SDK_RN_GITHUB_URL","type":"constant"},{"id":"READER_SDK_FLUTTER_GITHUB_URL","type":"constant"},{"id":"IAP_SDK_FLUTTER_GITHUB_URL","type":"constant"},{"id":"IAP_SDK_REACT_NATIVE_PLUGIN_GITHUB_URL","type":"constant"},{"id":"POS_ANDROID_SDK_GITHUB_URL","type":"constant"},{"id":"POS_IOS_SDK_GITHUB_URL","type":"constant"},{"id":"BUY_SQUARE_READER","type":"constant"},{"id":"FREE_MAGSTRIPE_READER","type":"constant"},{"id":"BUY_SQUARE_READER_IN_PERSON","type":"constant"},{"id":"MARKETPLACE_URL","type":"constant"},{"id":"IAP_SDK_FLUTTER_PLUGIN_GITHUB_URL","type":"constant"},{"id":"SQUARE_GIFT_CARDS","type":"constant"},{"id":"ANDROID_DEV_BASICS","type":"constant"},{"id":"ANDROID_DEV","type":"constant"},{"id":"GITHUB_CONNECT_V2_EXAMPLES","type":"constant"},{"id":"GITHUB_CONNECT_V1_EXAMPLES","type":"constant"},{"id":"IAP_TECH_REF_ANDROID","type":"constant"},{"id":"IAP_TECH_REF_IOS","type":"constant"},{"id":"SLACK_URL","type":"constant"},{"id":"SQUARE_TECH_REF","type":"constant"},{"id":"OLD_TECH_REF","type":"constant"},{"id":"NODEJS_SDK_TECH_REF_URL","type":"constant"},{"id":"PHP_SDK_TECH_REF_URL","type":"constant"},{"id":"DOTNET_SDK_TECH_REF_URL","type":"constant"},{"id":"JAVA_SDK_TECH_REF_URL","type":"constant"},{"id":"PYTHON_SDK_TECH_REF_URL","type":"constant"},{"id":"RUBY_SDK_TECH_REF_URL","type":"constant"},{"id":"TEST-CONSTANT","type":"constant"},{"id":"BUY_SQUARE_STAND","type":"constant"},{"id":"BUY_SQUARE_TERMINAL","type":"constant"},{"id":"API_EXPLORER_GA","type":"constant"},{"id":"NODEJS_SDK_NAME","type":"constant"},{"id":"SQUARE_SDK_REF","type":"constant"},{"id":"SQUARE_TECH_ROOT","type":"constant"}]}}},{"id":"3Io3VQwqKv9EhL99cLWG79","type":"markdown-block","attributes":{"name":"payment-form : add-digital-wallets : masterpass : step 5 (text)","markdown":"## Step 5: Customize the createPaymentRequest callback function\n\nTo process payments, you need to customize the `createPaymentRequest`\ncallback function to create a JSON block that defines a payment request object\nbased on the customer's purchase totals.\n\nDigital wallet services expect payment requests in a specific format. The result is that the object created in `createPaymentRequest` is functionally different from Square's internal data types. For example, monetary amounts are provided as floats [rather than integers](${CONNECT_TECH_REF}#type-money).\n\nFor more information about the expected structure of a payment request object, see\n[sqPaymentForm Object Model](${PAYMENT_FORM_TECH_REF}#paymentform-paymentrequestobjects).","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[{"id":"DEVELOPERS_URLS","type":"constant-set"}]}}},{"id":"4rKOIcIAVuXSycsCmuijeg","type":"markdown-block","attributes":{"name":"payment-form : add-digital-wallets : masterpass : step 5 (code) : javascript","markdown":"```javascript copy_code\n// Create and initialize a payment form object\nvar paymentForm = new SqPaymentForm({\n\n ...\n\n // SqPaymentForm callback functions\n callbacks: {\n\n ...\n\n /*\n * callback function: createPaymentRequest\n * Triggered when: a digital wallet payment button is clicked.\n */\n /*\n * callback function: createPayment Request\n * Triggered when: a digital wallet payment button is clicked.\n */\n createPaymentRequest: function () {\n return {\n requestShippingAddress: true,\n requestBillingInfo: true,\n shippingContact: {\n familyName: \"CUSTOMER LAST NAME\",\n givenName: \"CUSTOMER FIRST NAME\",\n email: \"mycustomer@example.com\",\n country: \"USA\",\n region: \"CA\",\n city: \"San Francisco\",\n addressLines: [\n \"1455 Market St #600\"\n ],\n postalCode: \"94103\",\n phone:\"14255551212\"\n },\n currencyCode: \"USD\",\n countryCode: \"US\",\n total: {\n label: \"MERCHANT NAME\",\n amount: \"85.00\",\n pending: false\n },\n lineItems: [\n {\n label: \"Subtotal\",\n amount: \"60.00\",\n pending: false\n },\n {\n label: \"Shipping\",\n amount: \"19.50\",\n pending: true\n },\n {\n label: \"Tax\",\n amount: \"5.50\",\n pending: false\n }\n ]\n },\n\n ...\n }\n});\n```","programming-language":"All","platform":"All"},"relationships":{"constant-sets":{"data":[]}}},{"id":"5BdjnmXXkm5wV0VO62OYPo","type":"multi-language-block","relationships":{"blocks":{"data":[{"id":"4rKOIcIAVuXSycsCmuijeg","type":"markdown-block"}]}}},{"id":"4vXFLZiEekx8TSwKB60kR5","type":"doc-page","attributes":{"slug":"payment-form/add-digital-wallets/masterpass","heading":{"id":"12A3lc4KnP8xvfMW3Imm2J","title":"Add a Secure Remote Commerce Button","eyebrow":"Square Payment Form: Add Digital Wallets","summary":null,"browser_title":"Add a Secure Remote Commerce Button","release_status":"DEPRECATED"},"environments":null,"related-pages":null,"search-summary":"Learn how to integrate the Secure Remote Commerce digital wallet with the Square payment form.","languages-supported":["All"],"platforms":["All"]},"relationships":{"content":{"data":[{"id":"77LtiJD967Bha2c6oqIEGU","type":"markdown-block"},{"id":"5DGFjDHv6huNzvmgQ5rjlw","type":"markdown-block"},{"id":"1ozaWmXh09AZfH7KQOuUDl","type":"markdown-block"},{"id":"3wngGAs8upi9v9teTXPMWL","type":"markdown-block"},{"id":"4gTciRSecaTgz3QpJwPGF2","type":"multi-language-block"},{"id":"2eVWNF9Bh0q8ggI1mXjlCh","type":"markdown-block"},{"id":"7md9voIKD3CbCu1QGcLMfp","type":"multi-language-block"},{"id":"1OTCjiVUMaBEFfPzxOaMFf","type":"markdown-block"},{"id":"wart7hBs1EeBJ8YJ5B3LL","type":"multi-language-block"},{"id":"4FBCr5yBY8o84ad5Squlnf","type":"markdown-block"},{"id":"13JiWk2vUNGHfR1xYMFiKu","type":"multi-language-block"},{"id":"3Io3VQwqKv9EhL99cLWG79","type":"markdown-block"},{"id":"5BdjnmXXkm5wV0VO62OYPo","type":"multi-language-block"}]},"constant-sets":{"data":[{"id":"DEVELOPERS_URLS","type":"constant-set"},{"id":"MD_BLOCKS","type":"constant-set"}]}}}]}

Add a Secure Remote Commerce Button

Warning