data, is a {@link LocalPayment~startPaymentPayload|startPaymentPayload}. If no callback is provided, the method will return a Promise that resolves with a {@link LocalPayment~startPaymentPayload|startPaymentPayload}.\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n * @example\n * localPaymentInstance.startPayment({\n * paymentType: 'ideal',\n * paymentTypeCountryCode: 'NL',\n * fallback: {\n * buttonText: 'Return to Merchant',\n * url: 'https://example.com/my-checkout-page'\n * },\n * amount: '10.00',\n * currencyCode: 'EUR',\n * givenName: 'Joe',\n * surname: 'Doe',\n * address: {\n * countryCode: 'NL'\n * },\n * onPaymentStart: function (data, continueCallback) {\n * // Do any preprocessing before starting the flow\n * // data.paymentId is the ID of the localPayment\n * continueCallback();\n * }\n * }).then(function (payload) {\n * // Submit payload.nonce to your server\n * }).catch(function (startPaymentError) {\n * // Handle flow errors or premature flow closure\n * console.error('Error!', startPaymentError);\n * });\n * @example data, is a {@link LocalPayment~startPaymentPayload|startPaymentPayload}. If no callback is provided, the method will return a Promise that resolves with a {@link LocalPayment~startPaymentPayload|startPaymentPayload}.\n * @example\n * localPaymentInstance.tokenize().then(function (payload) {\n * // send payload.nonce to your server\n * }).catch(function (err) {\n * // handle tokenization error\n * });\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n */\nLocalPayment.prototype.tokenize = function (params) {\n var self = this;\n var client = this._client;\n\n params = params || querystring.parse();\n\n // iOS Safari parses query params by adding the params inside an object called: queryItems\n if (params.queryItems) {\n params = params.queryItems;\n }\n\n if (params.c || params.wasCanceled) {\n return Promise.reject(\n new BraintreeError({\n type: errors.LOCAL_PAYMENT_CANCELED.type,\n code: errors.LOCAL_PAYMENT_CANCELED.code,\n message: errors.LOCAL_PAYMENT_CANCELED.message,\n details: {\n originalError: {\n errorcode: params.errorcode,\n token: params.btLpToken,\n },\n },\n })\n );\n } else if (params.errorcode) {\n return Promise.reject(\n new BraintreeError({\n type: errors.LOCAL_PAYMENT_START_PAYMENT_FAILED.type,\n code: errors.LOCAL_PAYMENT_START_PAYMENT_FAILED.code,\n message: errors.LOCAL_PAYMENT_START_PAYMENT_FAILED.message,\n details: {\n originalError: {\n errorcode: params.errorcode,\n token: params.btLpToken,\n },\n },\n })\n );\n }\n\n return client\n .request({\n endpoint: \"payment_methods/paypal_accounts\",\n method: \"post\",\n data: this._formatTokenizeData(params),\n })\n .then(function (response) {\n var payload = self._formatTokenizePayload(response);\n\n if (window.popupBridge) {\n analytics.sendEvent(\n client,\n self._paymentType + \".local-payment.tokenization.success-popupbridge\"\n );\n } else {\n analytics.sendEvent(\n client,\n self._paymentType + \".local-payment.tokenization.success\"\n );\n }\n\n return payload;\n })\n .catch(function (err) {\n analytics.sendEvent(\n client,\n self._paymentType + \".local-payment.tokenization.failed\"\n );\n\n return Promise.reject(\n convertToBraintreeError(err, {\n type: errors.LOCAL_PAYMENT_TOKENIZATION_FAILED.type,\n code: errors.LOCAL_PAYMENT_TOKENIZATION_FAILED.code,\n message: errors.LOCAL_PAYMENT_TOKENIZATION_FAILED.message,\n })\n );\n });\n};\n\n/**\n * Closes the LocalPayment window if it is open.\n * @public\n * @example\n * localPaymentInstance.closeWindow();\n * @returns {void}\n */\nLocalPayment.prototype.closeWindow = function () {\n if (this._authoriztionInProgress) {\n analytics.sendEvent(\n this._client,\n this._paymentType + \".local-payment.start-payment.closed.by-merchant\"\n );\n }\n this._frameService.close();\n};\n\n/**\n * Focuses the LocalPayment window if it is open.\n * @public\n * @example\n * localPaymentInstance.focusWindow();\n * @returns {void}\n */\nLocalPayment.prototype.focusWindow = function () {\n this._frameService.focus();\n};\n\nLocalPayment.prototype._createStartPaymentCallback = function (\n resolve,\n reject\n) {\n var self = this;\n var client = this._client;\n\n return function (err, params) {\n self._authorizationInProgress = false;\n if (err) {\n if (err.code === \"FRAME_SERVICE_FRAME_CLOSED\") {\n if (params && params.errorcode === \"processing_error\") {\n // something failed within the payment window (rather than when\n // tokenizing with Braintree)\n analytics.sendEvent(\n client,\n self._paymentType + \".local-payment.failed-in-window\"\n );\n reject(new BraintreeError(errors.LOCAL_PAYMENT_START_PAYMENT_FAILED));\n\n return;\n }\n\n // its possible to have a query param with errorcode=payment_error, which\n // indicates that the customer cancelled the flow from within the UI,\n // but as there's no meaningful difference to the merchant whether the\n // customer closes via the UI or by manually closing the window, we\n // don't differentiate these\n analytics.sendEvent(\n client,\n self._paymentType + \".local-payment.tokenization.closed.by-user\"\n );\n reject(new BraintreeError(errors.LOCAL_PAYMENT_WINDOW_CLOSED));\n } else if (\n err.code &&\n err.code.indexOf(\"FRAME_SERVICE_FRAME_OPEN_FAILED\") > -1\n ) {\n reject(\n new BraintreeError({\n code: errors.LOCAL_PAYMENT_WINDOW_OPEN_FAILED.code,\n type: errors.LOCAL_PAYMENT_WINDOW_OPEN_FAILED.type,\n message: errors.LOCAL_PAYMENT_WINDOW_OPEN_FAILED.message,\n details: {\n originalError: err,\n },\n })\n );\n }\n } else if (params) {\n if (!window.popupBridge) {\n self._frameService.redirect(self._loadingFrameUrl);\n }\n\n self\n .tokenize(params)\n .then(resolve)\n .catch(reject)\n .then(function () {\n self._frameService.close();\n });\n }\n };\n};\n\nLocalPayment.prototype._formatTokenizePayload = function (response) {\n var payload;\n var account = {};\n\n if (response.paypalAccounts) {\n account = response.paypalAccounts[0];\n }\n\n payload = {\n nonce: account.nonce,\n details: {},\n type: account.type,\n };\n\n if (account.details) {\n if (account.details.payerInfo) {\n payload.details = account.details.payerInfo;\n }\n if (account.details.correlationId) {\n payload.correlationId = account.details.correlationId;\n }\n }\n\n return payload;\n};\n\n/**\n * Checks if required tokenization parameters are available in querystring for manual tokenization requests.\n * @public\n * @function\n * @example\n * // if query string contains\n * // ?btLpToken=token&btLpPaymentId=payment-id&btLpPayerId=payer-id\n * localPaymentInstance.hasTokenizationParams(); // true\n *\n * // if query string has token: (full page redirect flow)\n * // ?token=abcdefg123456789\n * localPaymentInstance.hasTokenizationParams(); // true\n *\n * // if query string is missing required params\n * localPaymentInstance.hasTokenizationParams(); // false\n *\n * if (localPaymentInstance.hasTokenizationParams()) {\n * localPaymentInstance.tokenize();\n * }\n * @returns {Boolean} Returns a Boolean value for the state of the query string.\n */\nLocalPayment.prototype.hasTokenizationParams = function () {\n var params = querystring.parse();\n\n if (params.errorcode || params.token) {\n return true;\n }\n\n return Boolean(\n params.btLpToken && params.btLpPaymentId && params.btLpPayerId\n );\n};\n\nLocalPayment.prototype._formatTokenizeData = function (params) {\n var clientConfiguration = this._client.getConfiguration();\n var gatewayConfiguration = clientConfiguration.gatewayConfiguration;\n var data = {\n merchantAccountId: this._merchantAccountId,\n paypalAccount: {\n correlationId: params.btLpToken || params.token,\n paymentToken: params.btLpPaymentId || params.paymentId,\n payerId: params.btLpPayerId || params.PayerID,\n unilateral: gatewayConfiguration.paypal.unvettedMerchant,\n intent: \"sale\",\n },\n };\n\n return data;\n};\n\n// Some payment types are deferred. Meaning, the actual payment will\n// occur at a later time outside of this session. For example, with\n// Pay Upon Invoice, the customer will later receive an email that will\n// be used to make the actual payment through RatePay. This function\n// will return `true` if the given options contain `paymentType` of\n// a deferred payment type; and/or some payments, like blik, may have\n// specific extra options to be treated as deferred. Otherwise, it\n// will return `false`.\nfunction isDeferredPaymentTypeOptions(options) {\n var blikOptions = options.blikOptions || {};\n var paymentType =\n typeof options.paymentType === \"string\"\n ? options.paymentType.toLowerCase()\n : options.paymentType;\n\n if (paymentType === \"blik\") {\n return (\n blikOptions.hasOwnProperty(\"level_0\") ||\n blikOptions.hasOwnProperty(\"oneClick\")\n );\n }\n\n return [\"pay_upon_invoice\", \"mbway\", \"bancomatpay\"].includes(paymentType);\n}\n\nfunction hasMissingAddressOption(options) {\n var i, option;\n\n for (i = 0; i < constants.REQUIRED_OPTIONS_FOR_ADDRESS.length; i++) {\n option = constants.REQUIRED_OPTIONS_FOR_ADDRESS[i];\n if (!options.hasOwnProperty(option)) {\n return option;\n }\n }\n\n return false;\n}\n\nfunction hasMissingLineItemsOption(items) {\n var i, j, item, option;\n\n for (j = 0; j < items.length; j++) {\n item = items[j];\n for (i = 0; i < constants.REQUIRED_OPTIONS_FOR_LINE_ITEMS.length; i++) {\n option = constants.REQUIRED_OPTIONS_FOR_LINE_ITEMS[i];\n if (!item.hasOwnProperty(option)) {\n return option;\n }\n }\n }\n\n return false;\n}\n\nfunction hasMissingBlikOptions(options) {\n var i, option, oneClick;\n var blikOptions = options.blikOptions || {};\n\n if (!options.redirectUrl) {\n constants.REQUIRED_OPTIONS_FOR_BLIK_SEAMLESS_PAYMENT_TYPE.push(\n \"onPaymentStart\"\n );\n }\n\n for (\n i = 0;\n i < constants.REQUIRED_OPTIONS_FOR_BLIK_SEAMLESS_PAYMENT_TYPE.length;\n i++\n ) {\n option = constants.REQUIRED_OPTIONS_FOR_BLIK_SEAMLESS_PAYMENT_TYPE[i];\n if (!options.hasOwnProperty(option)) {\n return option;\n }\n }\n\n if (blikOptions.hasOwnProperty(\"level_0\")) {\n for (\n i = 0;\n i < constants.REQUIRED_OPTIONS_FOR_BLIK_OPTIONS_LEVEL_0.length;\n i++\n ) {\n option = constants.REQUIRED_OPTIONS_FOR_BLIK_OPTIONS_LEVEL_0[i];\n\n // eslint-disable-next-line camelcase\n if (!blikOptions.level_0.hasOwnProperty(option)) {\n return \"blikOptions.level_0.\" + option;\n }\n }\n } else if (blikOptions.hasOwnProperty(\"oneClick\")) {\n oneClick = blikOptions.oneClick || {};\n\n if (oneClick.hasOwnProperty(\"aliasKey\")) {\n for (\n i = 0;\n i <\n constants.REQUIRED_OPTIONS_FOR_BLIK_OPTIONS_ONE_CLICK_SUBSEQUENT.length;\n i++\n ) {\n option =\n constants.REQUIRED_OPTIONS_FOR_BLIK_OPTIONS_ONE_CLICK_SUBSEQUENT[i];\n\n if (!oneClick.hasOwnProperty(option)) {\n return \"blikOptions.oneClick.\" + option;\n }\n }\n } else {\n for (\n i = 0;\n i < constants.REQUIRED_OPTIONS_FOR_BLIK_OPTIONS_ONE_CLICK_FIRST.length;\n i++\n ) {\n option = constants.REQUIRED_OPTIONS_FOR_BLIK_OPTIONS_ONE_CLICK_FIRST[i];\n\n if (!oneClick.hasOwnProperty(option)) {\n return \"blikOptions.oneClick.\" + option;\n }\n }\n }\n }\n\n return false;\n}\n\n// This will return the name of the first missing required option that\n// is found or `true` if `options` itself is not defined. Otherwise, it\n// will return `false`.\nfunction hasMissingOption(options) {\n var i, option, missingAddressOption, missingLineItemOption, paymentType;\n\n if (!options) {\n return true;\n }\n\n if (isDeferredPaymentTypeOptions(options)) {\n paymentType = options.paymentType || \"\";\n\n if (paymentType.toLowerCase() === \"pay_upon_invoice\") {\n for (\n i = 0;\n i < constants.REQUIRED_OPTIONS_FOR_PAY_UPON_INVOICE_PAYMENT_TYPE.length;\n i++\n ) {\n option =\n constants.REQUIRED_OPTIONS_FOR_PAY_UPON_INVOICE_PAYMENT_TYPE[i];\n if (!options.hasOwnProperty(option)) {\n return option;\n }\n if (option === \"address\" || option === \"billingAddress\") {\n missingAddressOption = hasMissingAddressOption(options[option]);\n if (missingAddressOption) {\n return option + \".\" + missingAddressOption;\n }\n } else if (option === \"lineItems\") {\n missingLineItemOption = hasMissingLineItemsOption(options[option]);\n if (missingLineItemOption) {\n return option + \".\" + missingLineItemOption;\n }\n }\n }\n } else if (paymentType.toLowerCase() === \"blik\") {\n return hasMissingBlikOptions(options);\n }\n } else {\n if (!options.redirectUrl) {\n constants.REQUIRED_OPTIONS_FOR_START_PAYMENT.push(\"onPaymentStart\");\n }\n\n for (i = 0; i < constants.REQUIRED_OPTIONS_FOR_START_PAYMENT.length; i++) {\n option = constants.REQUIRED_OPTIONS_FOR_START_PAYMENT[i];\n\n if (!options.hasOwnProperty(option)) {\n return option;\n }\n }\n\n if (!options.fallback.url) {\n return \"fallback.url\";\n }\n if (!options.fallback.buttonText) {\n return \"fallback.buttonText\";\n }\n if (options.recurrent === true && !options.customerId) {\n return \"customerId\";\n }\n }\n\n return false;\n}\n\n/**\n * Cleanly remove anything set up by {@link module:braintree-web/local-payment.create|create}.\n * @public\n * @param {callback} [callback] Called on completion.\n * @example\n * localPaymentInstance.teardown();\n * @example data, is a {@link Masterpass~tokenizePayload|tokenizePayload}. If no callback is provided, the method will return a Promise that resolves with a {@link Masterpass~tokenizePayload|tokenizePayload}.\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n * @example\n * button.addEventListener('click', function () {\n * // Disable the button so that we don't attempt to open multiple popups.\n * button.setAttribute('disabled', 'disabled');\n *\n * // Because tokenize opens a new window, this must be called\n * // as a result of a user action, such as a button click.\n * masterpassInstance.tokenize({\n * currencyCode: 'USD',\n * subtotal: '10.00'\n * }).then(function (payload) {\n * button.removeAttribute('disabled');\n * // Submit payload.nonce to your server\n * }).catch(function (tokenizeError) {\n * button.removeAttribute('disabled');\n * // Handle flow errors or premature flow closure\n *\n * switch (tokenizeErr.code) {\n * case 'MASTERPASS_POPUP_CLOSED':\n * console.error('Customer closed Masterpass popup.');\n * break;\n * case 'MASTERPASS_ACCOUNT_TOKENIZATION_FAILED':\n * console.error('Masterpass tokenization failed. See details:', tokenizeErr.details);\n * break;\n * case 'MASTERPASS_FLOW_FAILED':\n * console.error('Unable to initialize Masterpass flow. Are your options correct?', tokenizeErr.details);\n * break;\n * default:\n * console.error('Error!', tokenizeErr);\n * }\n * });\n * });\n */\nMasterpass.prototype.tokenize = function (options) {\n var self = this;\n\n if (!options || hasMissingOption(options)) {\n return Promise.reject(\n new BraintreeError(errors.MASTERPASS_TOKENIZE_MISSING_REQUIRED_OPTION)\n );\n }\n\n if (self._authInProgress) {\n return Promise.reject(\n new BraintreeError(errors.MASTERPASS_TOKENIZATION_ALREADY_IN_PROGRESS)\n );\n }\n\n return new Promise(function (resolve, reject) {\n self._navigateFrameToLoadingPage(options).catch(reject);\n // This MUST happen after _navigateFrameToLoadingPage for Metro browsers to work.\n self._frameService.open(\n options.frameOptions,\n self._createFrameOpenHandler(resolve, reject)\n );\n });\n};\n\nMasterpass.prototype._navigateFrameToLoadingPage = function (options) {\n var self = this;\n\n this._authInProgress = true;\n\n return this._client\n .request({\n method: \"post\",\n endpoint: \"masterpass/request_token\",\n data: {\n requestToken: {\n originUrl: window.location.protocol + \"//\" + window.location.hostname,\n subtotal: options.subtotal,\n currencyCode: options.currencyCode,\n callbackUrl: this._callbackUrl,\n },\n },\n })\n .then(function (response) {\n var redirectUrl =\n self._assetsUrl +\n \"/html/masterpass-loading-frame\" +\n (self._isDebug ? \"\" : \".min\") +\n \".html?\";\n var gatewayConfiguration =\n self._client.getConfiguration().gatewayConfiguration;\n var config = options.config || {};\n var queryParams;\n\n queryParams = {\n environment: gatewayConfiguration.environment,\n requestToken: response.requestToken,\n callbackUrl: self._callbackUrl,\n merchantCheckoutId: gatewayConfiguration.masterpass.merchantCheckoutId,\n allowedCardTypes: gatewayConfiguration.masterpass.supportedNetworks,\n version: constants.MASTERPASS_VERSION,\n };\n\n Object.keys(config).forEach(function (key) {\n if (typeof config[key] !== \"function\") {\n queryParams[key] = config[key];\n }\n });\n\n redirectUrl += Object.keys(queryParams)\n .map(function (key) {\n return key + \"=\" + queryParams[key];\n })\n .join(\"&\");\n\n self._frameService.redirect(redirectUrl);\n })\n .catch(function (err) {\n var status = err.details && err.details.httpStatus;\n\n self._closeWindow();\n\n if (status === 422) {\n return Promise.reject(\n convertToBraintreeError(err, errors.MASTERPASS_INVALID_PAYMENT_OPTION)\n );\n }\n\n return Promise.reject(\n convertToBraintreeError(err, errors.MASTERPASS_FLOW_FAILED)\n );\n });\n};\n\nMasterpass.prototype._createFrameOpenHandler = function (resolve, reject) {\n var self = this;\n\n if (window.popupBridge) {\n return function (popupBridgeErr, payload) {\n self._authInProgress = false;\n\n if (popupBridgeErr) {\n analytics.sendEvent(\n self._client,\n \"masterpass.tokenization.closed-popupbridge.by-user\"\n );\n reject(\n convertToBraintreeError(\n popupBridgeErr,\n errors.MASTERPASS_POPUP_CLOSED\n )\n );\n\n return;\n } else if (!payload.queryItems) {\n analytics.sendEvent(\n self._client,\n \"masterpass.tokenization.failed-popupbridge\"\n );\n reject(new BraintreeError(errors.MASTERPASS_FLOW_FAILED));\n\n return;\n }\n\n self._tokenizeMasterpass(payload.queryItems).then(resolve).catch(reject);\n };\n }\n\n return function (frameServiceErr, payload) {\n if (frameServiceErr) {\n self._authInProgress = false;\n\n if (frameServiceErr.code === \"FRAME_SERVICE_FRAME_CLOSED\") {\n analytics.sendEvent(\n self._client,\n \"masterpass.tokenization.closed.by-user\"\n );\n reject(new BraintreeError(errors.MASTERPASS_POPUP_CLOSED));\n\n return;\n }\n\n if (\n frameServiceErr.code &&\n frameServiceErr.code.indexOf(\"FRAME_SERVICE_FRAME_OPEN_FAILED\") > -1\n ) {\n analytics.sendEvent(\n self._client,\n \"masterpass.tokenization.failed.to-open\"\n );\n reject(\n new BraintreeError({\n code: errors.MASTERPASS_POPUP_OPEN_FAILED.code,\n type: errors.MASTERPASS_POPUP_OPEN_FAILED.type,\n message: errors.MASTERPASS_POPUP_OPEN_FAILED.message,\n details: {\n originalError: frameServiceErr,\n },\n })\n );\n\n return;\n }\n\n analytics.sendEvent(self._client, \"masterpass.tokenization.failed\");\n self._closeWindow();\n reject(\n convertToBraintreeError(frameServiceErr, errors.MASTERPASS_FLOW_FAILED)\n );\n\n return;\n }\n\n self._tokenizeMasterpass(payload).then(resolve).catch(reject);\n };\n};\n\nMasterpass.prototype._tokenizeMasterpass = function (payload) {\n var self = this;\n\n if (payload.mpstatus !== \"success\") {\n analytics.sendEvent(self._client, \"masterpass.tokenization.closed.by-user\");\n self._closeWindow();\n\n return Promise.reject(new BraintreeError(errors.MASTERPASS_POPUP_CLOSED));\n }\n\n if (isMissingRequiredPayload(payload)) {\n analytics.sendEvent(\n self._client,\n \"masterpass.tokenization.closed.missing-payload\"\n );\n self._closeWindow();\n\n return Promise.reject(\n new BraintreeError(errors.MASTERPASS_POPUP_MISSING_REQUIRED_PARAMETERS)\n );\n }\n\n return self._client\n .request({\n endpoint: \"payment_methods/masterpass_cards\",\n method: \"post\",\n data: {\n masterpassCard: {\n checkoutResourceUrl: payload.checkout_resource_url,\n requestToken: payload.oauth_token,\n verifierToken: payload.oauth_verifier,\n },\n },\n })\n .then(function (response) {\n self._closeWindow();\n if (window.popupBridge) {\n analytics.sendEvent(\n self._client,\n \"masterpass.tokenization.success-popupbridge\"\n );\n } else {\n analytics.sendEvent(self._client, \"masterpass.tokenization.success\");\n }\n\n return response.masterpassCards[0];\n })\n .catch(function (tokenizeErr) {\n self._closeWindow();\n if (window.popupBridge) {\n analytics.sendEvent(\n self._client,\n \"masterpass.tokenization.failed-popupbridge\"\n );\n } else {\n analytics.sendEvent(self._client, \"masterpass.tokenization.failed\");\n }\n\n return Promise.reject(\n convertToBraintreeError(\n tokenizeErr,\n errors.MASTERPASS_ACCOUNT_TOKENIZATION_FAILED\n )\n );\n });\n};\n\nfunction isMissingRequiredPayload(payload) {\n return [\n payload.oauth_verifier,\n payload.oauth_token,\n payload.checkout_resource_url,\n ].some(function (element) {\n return element == null || element === \"null\";\n });\n}\n\nMasterpass.prototype._closeWindow = function () {\n this._authInProgress = false;\n this._frameService.close();\n};\n\n/**\n * Cleanly tear down anything set up by {@link module:braintree-web/masterpass.create|create}.\n * @public\n * @param {callback} [callback] Called on completion. If no callback is provided, `teardown` returns a promise.\n * @example\n * masterpassInstance.teardown();\n * @example data, is a {@link PaymentRequest~paymentPayload|paymentPayload}. If no callback is provided, `tokenize` returns a function that resolves with a {@link PaymentRequestComponent~tokenizePayload|tokenizePayload}.\n * @example\n * paymentRequestInstance.tokenize({\n * details: {\n * total: {\n * label: 'Price',\n * amount: {\n * currency: 'USD',\n * value: '100.00'\n * }\n * }\n * }\n * }).then(function (payload) {\n * // send payload.nonce to server\n *\n * // examine the raw response (with card details removed for security) from the payment request\n * console.log(payload.details.rawPaymentResponse);\n * }).catch(function (err) {\n * if (err.code === 'PAYMENT_REQUEST_CANCELED') {\n * // payment request was canceled by user\n * } else {\n * // an error occurred while processing\n * }\n * });\n * @example data, is the returned server data. If no callback is provided, `updatePayment` returns a promise that resolves with the server data.\n * @public\n * @param {object} options All options for the PayPalCheckout component.\n * @param {string} options.paymentId This should be PayPal `paymentId`.\n * @param {(string|number)} options.amount The amount of the transaction, including the amount of the selected shipping option, and all `line_items`.\n * * Supports up to 2 decimal digits.\n * @param {string} options.currency The currency code of the amount, such as 'USD'. Required when using the Checkout flow.\n * @param {string} [options.recipientEmail] Email address of the contact and shipping recipient of the order.\n * @param {shippingOption[]} [options.shippingOptions] List of {@link PayPalCheckout~shippingOption|shipping options} offered by the payee or merchant to the payer to ship or pick up their items.\n * @param {lineItem[]} [options.lineItems] The {@link PayPalCheckout~lineItem|line items} for this transaction. It can include up to 249 line items.\n * @param {object} [options.amountBreakdown] Optional collection of amounts that break down the total into individual pieces.\n * @param {string} [options.amountBreakdown.itemTotal] Optional, item amount\n * @param {string} [options.amountBreakdown.shipping] Optional, shipping amount\n * @param {string} [options.amountBreakdown.handling] Optional, handling amount\n * @param {string} [options.amountBreakdown.taxTotal] Optional, tax amount\n * @param {string} [options.amountBreakdown.insurance] Optional, insurance amount\n * @param {string} [options.amountBreakdown.shippingDiscount] Optional, shipping discount amount\n * @param {string} [options.amountBreakdown.discount] Optional, discount amount\n * @param {callback} [callback] The second argument is a PayPal `paymentId` or `billingToken` string, depending on whether `options.flow` is `checkout` or `vault`. This is also what is resolved by the promise if no callback is provided.\n * @example\n * // this paypal object is created by the PayPal JS SDK\n * // see https://github.com/paypal/paypal-checkout-components\n * paypal.Buttons({\n * createOrder: function () {\n * // when createPayment resolves, it is automatically passed to the PayPal JS SDK\n * return paypalCheckoutInstance.createPayment({\n * //\n * });\n * },\n * onShippingChange: function (data) {\n * // Examine data and determine if the payment needs to be updated.\n * // when updatePayment resolves, it is automatically passed to the PayPal JS SDK\n * return paypalCheckoutInstance.updatePayment({\n * paymentId: data.paymentId,\n * amount: '15.00',\n * currency: 'USD',\n * shippingOptions: [\n * {\n * id: 'shipping-speed-fast',\n * type: 'SHIPPING',\n * label: 'Fast Shipping',\n * selected: true,\n * amount: {\n * value: '5.00',\n * currency: 'USD'\n * }\n * },\n * {\n * id: 'shipping-speed-slow',\n * type: 'SHIPPING',\n * label: 'Slow Shipping',\n * selected: false,\n * amount: {\n * value: '1.00',\n * currency: 'USD'\n * }\n * }\n * ]\n * });\n * }\n * // Add other options, e.g. onApproved, onCancel, onError\n * }).render('#paypal-button');\n *\n * ```\n *\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n */\nPayPalCheckout.prototype.updatePayment = function (options) {\n var self = this;\n var endpoint = \"paypal_hermes/patch_payment_resource\";\n\n if (!options || this._hasMissingOption(options, constants.REQUIRED_OPTIONS)) {\n analytics.sendEventPlus(\n self._clientPromise,\n \"paypal-checkout.updatePayment.missing-options\",\n {\n paypal_context_id: self._contextId, // eslint-disable-line camelcase\n }\n );\n\n return Promise.reject(\n new BraintreeError(errors.PAYPAL_MISSING_REQUIRED_OPTION)\n );\n }\n\n if (!this._verifyConsistentCurrency(options)) {\n analytics.sendEventPlus(\n self._clientPromise,\n \"paypal-checkout.updatePayment.inconsistent-currencies\",\n {\n paypal_context_id: self._contextId, // eslint-disable-line camelcase\n }\n );\n\n return Promise.reject(\n new BraintreeError({\n type: errors.PAYPAL_INVALID_PAYMENT_OPTION.type,\n code: errors.PAYPAL_INVALID_PAYMENT_OPTION.code,\n message: errors.PAYPAL_INVALID_PAYMENT_OPTION.message,\n details: {\n originalError: new Error(\n \"One or more shipping option currencies differ from checkout currency.\"\n ),\n },\n })\n );\n }\n\n analytics.sendEventPlus(\n this._clientPromise,\n \"paypal-checkout.updatePayment\",\n {\n paypal_context_id: self._contextId, // eslint-disable-line camelcase\n }\n );\n\n return this._clientPromise\n .then(function (client) {\n return client.request({\n endpoint: endpoint,\n method: \"post\",\n data: self._formatUpdatePaymentData(options),\n });\n })\n .catch(function (err) {\n var status = err.details && err.details.httpStatus;\n\n if (status === 422) {\n analytics.sendEventPlus(\n self._clientPromise,\n \"paypal-checkout.updatePayment.invalid\",\n {\n paypal_context_id: self._contextId, // eslint-disable-line camelcase\n }\n );\n\n return Promise.reject(\n new BraintreeError({\n type: errors.PAYPAL_INVALID_PAYMENT_OPTION.type,\n code: errors.PAYPAL_INVALID_PAYMENT_OPTION.code,\n message: errors.PAYPAL_INVALID_PAYMENT_OPTION.message,\n details: {\n originalError: err,\n },\n })\n );\n }\n\n analytics.sendEventPlus(\n self._clientPromise,\n \"paypal-checkout.updatePayment.\" + errors.PAYPAL_FLOW_FAILED.code,\n {\n paypal_context_id: self._contextId, // eslint-disable-line camelcase\n }\n );\n\n return Promise.reject(\n convertToBraintreeError(err, {\n type: errors.PAYPAL_FLOW_FAILED.type,\n code: errors.PAYPAL_FLOW_FAILED.code,\n message: errors.PAYPAL_FLOW_FAILED.message,\n })\n );\n });\n};\n\n/**\n * Initializes the PayPal checkout flow with a payment method nonce that represents a vaulted PayPal account.\n * When a {@link callback} is defined, the function returns undefined and invokes the callback with the id to be used with the PayPal JS SDK. Otherwise, it returns a Promise that resolves with the id.\n * @public\n * @ignore\n * @param {object} options These options are identical to the {@link PayPalCheckout#createPayment|options for creating a payment resource}, except for the following:\n * * `flow` cannot be set (will always be `'checkout'`)\n * * `amount`, `currency`, and `vaultInitiatedCheckoutPaymentMethodToken` are required instead of optional\n * * Additional configuration is available (listed below)\n * @param {boolean} [options.optOutOfModalBackdrop=false] By default, the webpage will darken and become unusable while the PayPal window is open. For full control of the UI, pass `true` for this option.\n * @param {callback} [callback] The second argument, payload, is a {@link PayPalCheckout~tokenizePayload|tokenizePayload}. If no callback is provided, the promise resolves with a {@link PayPalCheckout~tokenizePayload|tokenizePayload}.\n * @example\n * paypalCheckoutInstance.startVaultInitiatedCheckout({\n * vaultInitiatedCheckoutPaymentMethodToken: 'nonce-that-represents-a-vaulted-paypal-account',\n * amount: '10.00',\n * currency: 'USD'\n * }).then(function (payload) {\n * // send payload.nonce to your server\n * }).catch(function (err) {\n * if (err.code === 'PAYPAL_POPUP_CLOSED') {\n * // indicates that customer canceled by\n * // manually closing the PayPal popup\n * }\n *\n * // handle other errors\n * });\n *\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n */\nPayPalCheckout.prototype.startVaultInitiatedCheckout = function (options) {\n var missingRequiredParam;\n var self = this;\n\n if (this._vaultInitiatedCheckoutInProgress) {\n analytics.sendEventPlus(\n this._clientPromise,\n \"paypal-checkout.startVaultInitiatedCheckout.error.already-in-progress\",\n {\n paypal_context_id: self._contextId, // eslint-disable-line camelcase\n }\n );\n\n return Promise.reject(\n new BraintreeError(\n errors.PAYPAL_START_VAULT_INITIATED_CHECKOUT_IN_PROGRESS\n )\n );\n }\n\n REQUIRED_PARAMS_FOR_START_VAULT_INITIATED_CHECKOUT.forEach(function (param) {\n if (!options.hasOwnProperty(param)) {\n missingRequiredParam = param;\n }\n });\n\n if (missingRequiredParam) {\n return Promise.reject(\n new BraintreeError({\n type: errors.PAYPAL_START_VAULT_INITIATED_CHECKOUT_PARAM_REQUIRED.type,\n code: errors.PAYPAL_START_VAULT_INITIATED_CHECKOUT_PARAM_REQUIRED.code,\n message: \"Required param \" + missingRequiredParam + \" is missing.\",\n })\n );\n }\n\n this._vaultInitiatedCheckoutInProgress = true;\n this._addModalBackdrop(options);\n\n options = assign({}, options, {\n flow: \"checkout\",\n });\n\n analytics.sendEventPlus(\n this._clientPromise,\n \"paypal-checkout.startVaultInitiatedCheckout.started\",\n {\n paypal_context_id: self._contextId, // eslint-disable-line camelcase\n }\n );\n\n return this._waitForVaultInitiatedCheckoutDependencies()\n .then(function () {\n var frameCommunicationPromise = new ExtendedPromise();\n var startVaultInitiatedCheckoutPromise = self\n ._createPaymentResource(options, {\n returnUrl: self._constructVaultCheckutUrl(\"redirect-frame\"),\n cancelUrl: self._constructVaultCheckutUrl(\"cancel-frame\"),\n })\n .then(function (response) {\n var redirectUrl = response.paymentResource.redirectUrl;\n\n self._frameService.redirect(redirectUrl);\n\n return frameCommunicationPromise;\n });\n\n self._frameService.open(\n {},\n self._createFrameServiceCallback(frameCommunicationPromise)\n );\n\n return startVaultInitiatedCheckoutPromise;\n })\n .catch(function (err) {\n self._vaultInitiatedCheckoutInProgress = false;\n self._removeModalBackdrop();\n\n if (err.code === \"FRAME_SERVICE_FRAME_CLOSED\") {\n analytics.sendEventPlus(\n self._clientPromise,\n \"paypal-checkout.startVaultInitiatedCheckout.canceled.by-customer\",\n {\n paypal_context_id: self._contextId, // eslint-disable-line camelcase\n }\n );\n\n return Promise.reject(\n new BraintreeError(\n errors.PAYPAL_START_VAULT_INITIATED_CHECKOUT_CANCELED\n )\n );\n }\n\n if (self._frameService) {\n self._frameService.close();\n }\n\n if (\n err.code &&\n err.code.indexOf(\"FRAME_SERVICE_FRAME_OPEN_FAILED\") > -1\n ) {\n analytics.sendEventPlus(\n self._clientPromise,\n \"paypal-checkout.startVaultInitiatedCheckout.failed.popup-not-opened\",\n {\n paypal_context_id: self._contextId, // eslint-disable-line camelcase\n }\n );\n\n return Promise.reject(\n new BraintreeError({\n code: errors.PAYPAL_START_VAULT_INITIATED_CHECKOUT_POPUP_OPEN_FAILED\n .code,\n type: errors.PAYPAL_START_VAULT_INITIATED_CHECKOUT_POPUP_OPEN_FAILED\n .type,\n message:\n errors.PAYPAL_START_VAULT_INITIATED_CHECKOUT_POPUP_OPEN_FAILED\n .message,\n details: {\n originalError: err,\n },\n })\n );\n }\n\n return Promise.reject(err);\n })\n .then(function (response) {\n self._frameService.close();\n self._vaultInitiatedCheckoutInProgress = false;\n self._removeModalBackdrop();\n analytics.sendEventPlus(\n self._clientPromise,\n \"paypal-checkout.startVaultInitiatedCheckout.succeeded\",\n {\n paypal_context_id: self._contextId, // eslint-disable-line camelcase\n }\n );\n\n return Promise.resolve(response);\n });\n};\n\nPayPalCheckout.prototype._addModalBackdrop = function (options) {\n if (options.optOutOfModalBackdrop) {\n return;\n }\n\n if (!this._modalBackdrop) {\n this._modalBackdrop = document.createElement(\"div\");\n this._modalBackdrop.setAttribute(\n \"data-braintree-paypal-vault-initiated-checkout-modal\",\n true\n );\n this._modalBackdrop.style.position = \"fixed\";\n this._modalBackdrop.style.top = 0;\n this._modalBackdrop.style.bottom = 0;\n this._modalBackdrop.style.left = 0;\n this._modalBackdrop.style.right = 0;\n this._modalBackdrop.style.zIndex = 9999;\n this._modalBackdrop.style.background = \"black\";\n this._modalBackdrop.style.opacity = \"0.7\";\n this._modalBackdrop.addEventListener(\n \"click\",\n function () {\n this.focusVaultInitiatedCheckoutWindow();\n }.bind(this)\n );\n }\n\n document.body.appendChild(this._modalBackdrop);\n};\n\nPayPalCheckout.prototype._removeModalBackdrop = function () {\n if (!(this._modalBackdrop && this._modalBackdrop.parentNode)) {\n return;\n }\n\n this._modalBackdrop.parentNode.removeChild(this._modalBackdrop);\n};\n\n/**\n * Closes the PayPal window if it is opened via `startVaultInitiatedCheckout`.\n * @public\n * @ignore\n * @param {callback} [callback] Gets called when window is closed.\n * @example\n * paypalCheckoutInstance.closeVaultInitiatedCheckoutWindow();\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n */\nPayPalCheckout.prototype.closeVaultInitiatedCheckoutWindow = function () {\n if (this._vaultInitiatedCheckoutInProgress) {\n analytics.sendEventPlus(\n this._clientPromise,\n \"paypal-checkout.startVaultInitiatedCheckout.canceled.by-merchant\",\n {\n paypal_context_id: this._contextId, // eslint-disable-line camelcase\n }\n );\n }\n\n return this._waitForVaultInitiatedCheckoutDependencies().then(\n function () {\n this._frameService.close();\n }.bind(this)\n );\n};\n\n/**\n * Focuses the PayPal window if it is opened via `startVaultInitiatedCheckout`.\n * @public\n * @ignore\n * @param {callback} [callback] Gets called when window is focused.\n * @example\n * paypalCheckoutInstance.focusVaultInitiatedCheckoutWindow();\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n */\nPayPalCheckout.prototype.focusVaultInitiatedCheckoutWindow = function () {\n return this._waitForVaultInitiatedCheckoutDependencies().then(\n function () {\n this._frameService.focus();\n }.bind(this)\n );\n};\n\nPayPalCheckout.prototype._createFrameServiceCallback = function (\n frameCommunicationPromise\n) {\n var self = this;\n\n // TODO when a merchant integrates an iOS or Android integration\n // with a webview using the web SDK, we will have to add popupbridge\n // support\n return function (err, payload) {\n if (err) {\n frameCommunicationPromise.reject(err);\n } else if (payload) {\n self._frameService.redirect(self._loadingFrameUrl);\n self\n .tokenizePayment({\n paymentToken: payload.token,\n payerID: payload.PayerID,\n paymentID: payload.paymentId,\n orderID: payload.orderId,\n })\n .then(function (res) {\n frameCommunicationPromise.resolve(res);\n })\n .catch(function (tokenizationError) {\n frameCommunicationPromise.reject(tokenizationError);\n });\n }\n };\n};\n\nPayPalCheckout.prototype._waitForVaultInitiatedCheckoutDependencies =\n function () {\n var self = this;\n\n return this._clientPromise.then(function () {\n return self._frameServicePromise;\n });\n };\n\nPayPalCheckout.prototype._constructVaultCheckutUrl = function (frameName) {\n var serviceId = this._frameService._serviceId;\n\n return (\n this._assetsUrl +\n \"/html/\" +\n frameName +\n useMin(this._isDebug) +\n \".html?channel=\" +\n serviceId\n );\n};\n\n/**\n * Tokenizes the authorize data from the PayPal JS SDK when completing a buyer approval flow.\n * When a {@link callback} is defined, invokes the callback with {@link PayPalCheckout~tokenizePayload|tokenizePayload} and returns undefined. Otherwise, returns a Promise that resolves with a {@link PayPalCheckout~tokenizePayload|tokenizePayload}.\n * @public\n * @param {object} tokenizeOptions Tokens and IDs required to tokenize the payment.\n * @param {string} tokenizeOptions.payerId Payer ID returned by PayPal `onApproved` callback.\n * @param {string} [tokenizeOptions.paymentId] Payment ID returned by PayPal `onApproved` callback.\n * @param {string} [tokenizeOptions.billingToken] Billing Token returned by PayPal `onApproved` callback.\n * @param {boolean} [tokenizeOptions.vault=true] Whether or not to vault the resulting PayPal account (if using a client token generated with a customer id and the vault flow).\n * @param {callback} [callback] The second argument, payload, is a {@link PayPalCheckout~tokenizePayload|tokenizePayload}. If no callback is provided, the promise resolves with a {@link PayPalCheckout~tokenizePayload|tokenizePayload}.\n * @example id, is a the PayPal client id. If no callback is provided, the promise resolves with the PayPal client id.\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n * @example\n * paypalCheckoutInstance.getClientId().then(function (id) {\n * var script = document.createElement('script');\n *\n * script.src = 'https://www.paypal.com/sdk/js?client-id=' + id;\n * script.onload = function () {\n * // setup the PayPal SDK\n * };\n *\n * document.body.appendChild(script);\n * });\n */\nPayPalCheckout.prototype.getClientId = function () {\n return this._clientPromise.then(function (client) {\n return client.getConfiguration().gatewayConfiguration.paypal.clientId;\n });\n};\n\n/**\n * Resolves when the PayPal SDK has been successfully loaded onto the page.\n * @public\n * @param {object} [options] A configuration object to modify the query params and data-attributes on the PayPal SDK. A subset of the parameters are listed below. For a full list of query params, see the [PayPal docs](https://developer.paypal.com/docs/checkout/reference/customize-sdk/?mark=query#query-parameters).\n * @param {string} [options.client-id] By default, this will be the client id associated with the authorization used to create the Braintree component. When used in conjunction with passing `authorization` when creating the PayPal Checkout component, you can speed up the loading of the PayPal SDK.\n * @param {string} [options.intent=\"authorize\"] By default, the PayPal SDK defaults to an intent of `capture`. Since the default intent when calling {@link PayPalCheckout#createPayment|`createPayment`} is `authorize`, the PayPal SDK will be loaded with `intent=authorize`. If you wish to use a different intent when calling {@link PayPalCheckout#createPayment|`createPayment`}, make sure it matches here. If `sale` is used, it will be converted to `capture` for the PayPal SDK. If the `vault: true` param is used, `tokenize` will be passed as the default intent.\n * @param {string} [options.locale=en_US] Use this option to change the language, links, and terminology used in the PayPal flow. This locale will be used unless the buyer has set a preferred locale for their account. If an unsupported locale is supplied, a fallback locale (determined by buyer preference or browser data) will be used and no error will be thrown.\n *\n * Supported locales are:\n * `da_DK`,\n * `de_DE`,\n * `en_AU`,\n * `en_GB`,\n * `en_US`,\n * `es_ES`,\n * `fr_CA`,\n * `fr_FR`,\n * `id_ID`,\n * `it_IT`,\n * `ja_JP`,\n * `ko_KR`,\n * `nl_NL`,\n * `no_NO`,\n * `pl_PL`,\n * `pt_BR`,\n * `pt_PT`,\n * `ru_RU`,\n * `sv_SE`,\n * `th_TH`,\n * `zh_CN`,\n * `zh_HK`,\n * and `zh_TW`.\n *\n * @param {string} [options.currency=\"USD\"] If a currency is passed in {@link PayPalCheckout#createPayment|`createPayment`}, it must match the currency passed here.\n * @param {boolean} [options.vault] Must be `true` when using `flow: vault` in {@link PayPalCheckout#createPayment|`createPayment`}.\n * @param {string} [options.components=buttons] By default, the Braintree SDK will only load the PayPal smart buttons component. If you would like to load just the [messages component](https://developer.paypal.com/docs/business/checkout/add-capabilities/credit-messaging/), pass `messages`. If you would like to load both, pass `buttons,messages`\n * @param {object} [options.dataAttributes] The data attributes to apply to the script. Any data attribute can be passed. A subset of the parameters are listed below. For a full list of data attributes, see the [PayPal docs](https://developer.paypal.com/docs/checkout/reference/customize-sdk/#script-parameters).\n * @param {string} [options.dataAttributes.client-token] The client token to use in the script. (usually not needed)\n * @param {string} [options.dataAttributes.csp-nonce] See the [PayPal docs about content security nonces](https://developer.paypal.com/docs/checkout/reference/customize-sdk/#csp-nonce).\n * @param {callback} [callback] Called when the PayPal SDK has been loaded onto the page. The second argument is the PayPal Checkout instance. If no callback is provided, the promise resolves with the PayPal Checkout instance when the PayPal SDK has been loaded onto the page.\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n * @example data, is a {@link PayPal~tokenizePayload|tokenizePayload}.\n * @example\n * data, is a {@link ThreeDSecure~verifyPayload|verifyPayload}. If no callback is provided, it will return a promise that resolves {@link ThreeDSecure~verifyPayload|verifyPayload}.\n\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n * @example\n * data, is a {@link ThreeDSecure~prepareLookupPayload|prepareLookupPayload}. If no callback is provided, it will return a promise that resolves {@link ThreeDSecure~prepareLookupPayload|prepareLookupPayload}.\n\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n * @example\n * data, is a {@link UnionPay#fetchCapabilitiesPayload fetchCapabilitiesPayload}. If no callback is provided, `fetchCapabilities` returns a promise that resolves with a {@link UnionPay#fetchCapabilitiesPayload fetchCapabilitiesPayload}.\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n */\nUnionPay.prototype.fetchCapabilities = function (options) {\n var self = this;\n var client = this._options.client;\n var cardNumber = options.card ? options.card.number : null;\n var hostedFields = options.hostedFields;\n\n if (cardNumber && hostedFields) {\n return Promise.reject(\n new BraintreeError(errors.UNIONPAY_CARD_AND_HOSTED_FIELDS_INSTANCES)\n );\n } else if (cardNumber) {\n return client\n .request({\n method: \"get\",\n endpoint: \"payment_methods/credit_cards/capabilities\",\n data: {\n _meta: { source: \"unionpay\" },\n creditCard: {\n number: cardNumber,\n },\n },\n })\n .then(function (response) {\n analytics.sendEvent(client, \"unionpay.capabilities-received\");\n\n return response;\n })\n .catch(function (err) {\n var status = err.details && err.details.httpStatus;\n\n analytics.sendEvent(client, \"unionpay.capabilities-failed\");\n\n if (status === 403) {\n return Promise.reject(err);\n }\n\n return Promise.reject(\n new BraintreeError({\n type: errors.UNIONPAY_FETCH_CAPABILITIES_NETWORK_ERROR.type,\n code: errors.UNIONPAY_FETCH_CAPABILITIES_NETWORK_ERROR.code,\n message: errors.UNIONPAY_FETCH_CAPABILITIES_NETWORK_ERROR.message,\n details: {\n originalError: err,\n },\n })\n );\n });\n } else if (hostedFields) {\n if (!hostedFields._bus) {\n return Promise.reject(\n new BraintreeError(errors.UNIONPAY_HOSTED_FIELDS_INSTANCE_INVALID)\n );\n }\n\n return self._initializeHostedFields().then(function () {\n return new Promise(function (resolve, reject) {\n self._bus.emit(\n events.HOSTED_FIELDS_FETCH_CAPABILITIES,\n { hostedFields: hostedFields },\n function (response) {\n if (response.err) {\n reject(new BraintreeError(response.err));\n\n return;\n }\n\n resolve(response.payload);\n }\n );\n });\n });\n }\n\n return Promise.reject(\n new BraintreeError(errors.UNIONPAY_CARD_OR_HOSTED_FIELDS_INSTANCE_REQUIRED)\n );\n};\n\n/**\n * @typedef {object} UnionPay~enrollPayload\n * @property {string} enrollmentId UnionPay enrollment ID. This value should be passed to `tokenize`.\n * @property {boolean} smsCodeRequired UnionPay `smsCodeRequired` flag.\n * true - the user will receive an SMS code that needs to be supplied for tokenization.\n * false - the card can be immediately tokenized.\n */\n\n/**\n * Enrolls a UnionPay card. Use {@link UnionPay#fetchCapabilities|fetchCapabilities} to determine if the SMS enrollment process is required.\n * @public\n * @param {object} options UnionPay enrollment options:\n * @param {object} [options.card] The card to enroll. Required if you are not using the `hostedFields` option.\n * @param {string} options.card.number The card number.\n * @param {string} [options.card.expirationDate] The card's expiration date. May be in the form `MM/YY` or `MM/YYYY`. When defined `expirationMonth` and `expirationYear` are ignored.\n * @param {string} [options.card.expirationMonth] The card's expiration month. This should be used with the `expirationYear` parameter. When `expirationDate` is defined this parameter is ignored.\n * @param {string} [options.card.expirationYear] The card's expiration year. This should be used with the `expirationMonth` parameter. When `expirationDate` is defined this parameter is ignored.\n * @param {HostedFields} [options.hostedFields] The Hosted Fields instance used to collect card data. Required if you are not using the `card` option.\n * @param {object} options.mobile The mobile information collected from the customer.\n * @param {string} options.mobile.countryCode The country code of the customer's mobile phone number.\n * @param {string} options.mobile.number The customer's mobile phone number.\n * @param {callback} [callback] The second argument, data, is a {@link UnionPay~enrollPayload|enrollPayload}. If no callback is provided, `enroll` returns a promise that resolves with {@link UnionPay~enrollPayload|enrollPayload}.\n * @returns {void}\n */\nUnionPay.prototype.enroll = function (options) {\n var self = this;\n var client = this._options.client;\n var card = options.card;\n var mobile = options.mobile;\n var hostedFields = options.hostedFields;\n var data;\n\n if (!mobile) {\n return Promise.reject(\n new BraintreeError(errors.UNIONPAY_MISSING_MOBILE_PHONE_DATA)\n );\n }\n\n if (hostedFields) {\n if (!hostedFields._bus) {\n return Promise.reject(\n new BraintreeError(errors.UNIONPAY_HOSTED_FIELDS_INSTANCE_INVALID)\n );\n } else if (card) {\n return Promise.reject(\n new BraintreeError(errors.UNIONPAY_CARD_AND_HOSTED_FIELDS_INSTANCES)\n );\n }\n\n return new Promise(function (resolve, reject) {\n self._initializeHostedFields().then(function () {\n self._bus.emit(\n events.HOSTED_FIELDS_ENROLL,\n { hostedFields: hostedFields, mobile: mobile },\n function (response) {\n if (response.err) {\n reject(new BraintreeError(response.err));\n\n return;\n }\n\n resolve(response.payload);\n }\n );\n });\n });\n } else if (card && card.number) {\n data = {\n _meta: { source: \"unionpay\" },\n unionPayEnrollment: {\n number: card.number,\n mobileCountryCode: mobile.countryCode,\n mobileNumber: mobile.number,\n },\n };\n\n if (card.expirationDate) {\n data.unionPayEnrollment.expirationDate = card.expirationDate;\n } else if (card.expirationMonth || card.expirationYear) {\n if (card.expirationMonth && card.expirationYear) {\n data.unionPayEnrollment.expirationYear = card.expirationYear;\n data.unionPayEnrollment.expirationMonth = card.expirationMonth;\n } else {\n return Promise.reject(\n new BraintreeError(errors.UNIONPAY_EXPIRATION_DATE_INCOMPLETE)\n );\n }\n }\n\n return client\n .request({\n method: \"post\",\n endpoint: \"union_pay_enrollments\",\n data: data,\n })\n .then(function (response) {\n analytics.sendEvent(client, \"unionpay.enrollment-succeeded\");\n\n return {\n enrollmentId: response.unionPayEnrollmentId,\n smsCodeRequired: response.smsCodeRequired,\n };\n })\n .catch(function (err) {\n var error;\n var status = err.details && err.details.httpStatus;\n\n if (status === 403) {\n error = err;\n } else if (status < 500) {\n error = new BraintreeError(\n errors.UNIONPAY_ENROLLMENT_CUSTOMER_INPUT_INVALID\n );\n error.details = { originalError: err };\n } else {\n error = new BraintreeError(errors.UNIONPAY_ENROLLMENT_NETWORK_ERROR);\n error.details = { originalError: err };\n }\n\n analytics.sendEvent(client, \"unionpay.enrollment-failed\");\n\n return Promise.reject(error);\n });\n }\n\n return Promise.reject(\n new BraintreeError(errors.UNIONPAY_CARD_OR_HOSTED_FIELDS_INSTANCE_REQUIRED)\n );\n};\n\n/**\n * @typedef {object} UnionPay~tokenizePayload\n * @property {string} nonce The payment method nonce.\n * @property {string} type Always CreditCard.\n * @property {object} details Additional account details:\n * @property {string} details.cardType Type of card, ex: Visa, MasterCard.\n * @property {string} details.lastFour Last four digits of card number.\n * @property {string} details.lastTwo Last two digits of card number.\n * @property {string} description A human-readable description.\n */\n\n/**\n * Tokenizes a UnionPay card and returns a nonce payload.\n * @public\n * @param {object} options UnionPay tokenization options:\n * @param {object} [options.card] The card to enroll. Required if you are not using the `hostedFields` option.\n * @param {string} options.card.number The card number.\n * @param {string} [options.card.expirationDate] The card's expiration date. May be in the form `MM/YY` or `MM/YYYY`. When defined `expirationMonth` and `expirationYear` are ignored.\n * @param {string} [options.card.expirationMonth] The card's expiration month. This should be used with the `expirationYear` parameter. When `expirationDate` is defined this parameter is ignored.\n * @param {string} [options.card.expirationYear] The card's expiration year. This should be used with the `expirationMonth` parameter. When `expirationDate` is defined this parameter is ignored.\n * @param {string} [options.card.cvv] The card's security number.\n * @param {HostedFields} [options.hostedFields] The Hosted Fields instance used to collect card data. Required if you are not using the `card` option.\n * @param {string} options.enrollmentId The enrollment ID from {@link UnionPay#enroll}.\n * @param {string} [options.smsCode] The SMS code received from the user if {@link UnionPay#enroll} payload have `smsCodeRequired`. if `smsCodeRequired` is false, smsCode should not be passed.\n * @param {callback} [callback] The second argument, data, is a {@link UnionPay~tokenizePayload|tokenizePayload}. If no callback is provided, `tokenize` returns a promise that resolves with a {@link UnionPay~tokenizePayload|tokenizePayload}.\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n */\nUnionPay.prototype.tokenize = function (options) {\n var data;\n var self = this;\n var client = this._options.client;\n var card = options.card;\n var hostedFields = options.hostedFields;\n\n if (card && hostedFields) {\n return Promise.reject(\n new BraintreeError(errors.UNIONPAY_CARD_AND_HOSTED_FIELDS_INSTANCES)\n );\n } else if (card) {\n data = {\n _meta: { source: \"unionpay\" },\n creditCard: {\n number: options.card.number,\n options: {\n unionPayEnrollment: {\n id: options.enrollmentId,\n },\n },\n },\n };\n\n if (options.smsCode) {\n data.creditCard.options.unionPayEnrollment.smsCode = options.smsCode;\n }\n\n if (card.expirationDate) {\n data.creditCard.expirationDate = card.expirationDate;\n } else if (card.expirationMonth && card.expirationYear) {\n data.creditCard.expirationYear = card.expirationYear;\n data.creditCard.expirationMonth = card.expirationMonth;\n }\n\n if (options.card.cvv) {\n data.creditCard.cvv = options.card.cvv;\n }\n\n return client\n .request({\n method: \"post\",\n endpoint: \"payment_methods/credit_cards\",\n data: data,\n })\n .then(function (response) {\n var tokenizedCard = response.creditCards[0];\n\n delete tokenizedCard.consumed;\n delete tokenizedCard.threeDSecureInfo;\n\n analytics.sendEvent(client, \"unionpay.nonce-received\");\n\n return tokenizedCard;\n })\n .catch(function (err) {\n var error;\n var status = err.details && err.details.httpStatus;\n\n analytics.sendEvent(client, \"unionpay.nonce-failed\");\n\n if (status === 403) {\n error = err;\n } else if (status < 500) {\n error = new BraintreeError(errors.UNIONPAY_FAILED_TOKENIZATION);\n error.details = { originalError: err };\n } else {\n error = new BraintreeError(\n errors.UNIONPAY_TOKENIZATION_NETWORK_ERROR\n );\n error.details = { originalError: err };\n }\n\n return Promise.reject(error);\n });\n } else if (hostedFields) {\n if (!hostedFields._bus) {\n return Promise.reject(\n new BraintreeError(errors.UNIONPAY_HOSTED_FIELDS_INSTANCE_INVALID)\n );\n }\n\n return new Promise(function (resolve, reject) {\n self._initializeHostedFields().then(function () {\n self._bus.emit(\n events.HOSTED_FIELDS_TOKENIZE,\n options,\n function (response) {\n if (response.err) {\n reject(new BraintreeError(response.err));\n\n return;\n }\n\n resolve(response.payload);\n }\n );\n });\n });\n }\n\n return Promise.reject(\n new BraintreeError(errors.UNIONPAY_CARD_OR_HOSTED_FIELDS_INSTANCE_REQUIRED)\n );\n};\n\n/**\n * Cleanly remove anything set up by {@link module:braintree-web/unionpay.create|create}. This only needs to be called when using UnionPay with Hosted Fields.\n * @public\n * @param {callback} [callback] Called on completion. If no callback is provided, returns a promise.\n * @example\n * unionpayInstance.teardown();\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n */\nUnionPay.prototype.teardown = function () {\n if (this._bus) {\n this._hostedFieldsFrame.parentNode.removeChild(this._hostedFieldsFrame);\n this._bus.teardown();\n }\n\n convertMethodsToError(this, methods(UnionPay.prototype));\n\n return Promise.resolve();\n};\n\nUnionPay.prototype._initializeHostedFields = function () {\n var assetsUrl, isDebug;\n var componentId = uuid();\n var self = this;\n\n if (this._hostedFieldsInitializePromise) {\n return this._hostedFieldsInitializePromise;\n }\n\n this._hostedFieldsInitializePromise = new Promise(function (resolve) {\n assetsUrl =\n self._options.client.getConfiguration().gatewayConfiguration.assetsUrl;\n isDebug = self._options.client.getConfiguration().isDebug;\n\n self._bus = new Bus({\n channel: componentId,\n verifyDomain: isVerifiedDomain,\n });\n self._hostedFieldsFrame = iFramer({\n name: constants.HOSTED_FIELDS_FRAME_NAME + \"_\" + componentId,\n src:\n assetsUrl +\n \"/web/\" +\n VERSION +\n \"/html/unionpay-hosted-fields-frame\" +\n useMin(isDebug) +\n \".html\",\n height: 0,\n width: 0,\n });\n\n self._bus.on(BUS_CONFIGURATION_REQUEST_EVENT, function (reply) {\n reply(self._options.client);\n\n resolve();\n });\n\n document.body.appendChild(self._hostedFieldsFrame);\n });\n\n return this._hostedFieldsInitializePromise;\n};\n\nmodule.exports = wrapPromise.wrapPrototype(UnionPay);\n\n},{\"../../lib/analytics\":135,\"../../lib/braintree-error\":140,\"../../lib/constants\":142,\"../../lib/convert-methods-to-error\":143,\"../../lib/is-verified-domain\":170,\"../../lib/methods\":172,\"../../lib/use-min\":178,\"./constants\":221,\"./errors\":222,\"@braintree/iframer\":32,\"@braintree/uuid\":36,\"@braintree/wrap-promise\":40,\"framebus\":50}],224:[function(_dereq_,module,exports){\n\"use strict\";\n\nmodule.exports = {\n PLAID_LINK_JS: \"https://cdn.plaid.com/link/v2/stable/link-initialize.js\",\n};\n\n},{}],225:[function(_dereq_,module,exports){\n\"use strict\";\n\n/**\n * @name BraintreeError.Us Bank Account - Creation Error Codes\n * @description Errors that occur when [creating the Us Bank Account component](./module-braintree-web_us-bank-account.html#.create).\n * @property {MERCHANT} US_BANK_ACCOUNT_NOT_ENABLED Occurs when US Bank Account is not enabled in the Braintree control panel.\n */\n\n/**\n * @name BraintreeError.Us Bank Account - tokenize Error Codes\n * @description Errors that occur when using the [`tokenize` method](./UsBankAccount.html#tokenize).\n * @property {MERCHANT} US_BANK_ACCOUNT_OPTION_REQUIRED Occurs when a required option is not passed.\n * @property {MERCHANT} US_BANK_ACCOUNT_MUTUALLY_EXCLUSIVE_OPTIONS Occurs when 1 or more incompatible options are passed.\n * @property {NETWORK} US_BANK_ACCOUNT_LOGIN_LOAD_FAILED Occurs when bank login flow fails.\n * @property {CUSTOMER} US_BANK_ACCOUNT_LOGIN_CLOSED Occurs when bank login window is closed.\n * @property {MERCHANT} US_BANK_ACCOUNT_LOGIN_REQUEST_ACTIVE Occurs when a bank login flow is already active.\n * @property {NETWORK} US_BANK_ACCOUNT_TOKENIZATION_NETWORK_ERROR Occurs when payment details could not be tokenized.\n * @property {CUSTOMER} US_BANK_ACCOUNT_FAILED_TOKENIZATION Occurs when payment details failed to be tokenized.\n * @property {MERCHANT} US_BANK_ACCOUNT_BANK_LOGIN_NOT_ENABLED Occurs when bank login flow is not enabled in the Braintree control panel.\n */\n\nvar BraintreeError = _dereq_(\"../lib/braintree-error\");\n\nmodule.exports = {\n US_BANK_ACCOUNT_OPTION_REQUIRED: {\n type: BraintreeError.types.MERCHANT,\n code: \"US_BANK_ACCOUNT_OPTION_REQUIRED\",\n },\n US_BANK_ACCOUNT_MUTUALLY_EXCLUSIVE_OPTIONS: {\n type: BraintreeError.types.MERCHANT,\n code: \"US_BANK_ACCOUNT_MUTUALLY_EXCLUSIVE_OPTIONS\",\n },\n US_BANK_ACCOUNT_LOGIN_LOAD_FAILED: {\n type: BraintreeError.types.NETWORK,\n code: \"US_BANK_ACCOUNT_LOGIN_LOAD_FAILED\",\n message: \"Bank login flow failed to load.\",\n },\n US_BANK_ACCOUNT_LOGIN_CLOSED: {\n type: BraintreeError.types.CUSTOMER,\n code: \"US_BANK_ACCOUNT_LOGIN_CLOSED\",\n message: \"Customer closed bank login flow before authorizing.\",\n },\n US_BANK_ACCOUNT_LOGIN_REQUEST_ACTIVE: {\n type: BraintreeError.types.MERCHANT,\n code: \"US_BANK_ACCOUNT_LOGIN_REQUEST_ACTIVE\",\n message: \"Another bank login tokenization request is active.\",\n },\n US_BANK_ACCOUNT_TOKENIZATION_NETWORK_ERROR: {\n type: BraintreeError.types.NETWORK,\n code: \"US_BANK_ACCOUNT_TOKENIZATION_NETWORK_ERROR\",\n message: \"A tokenization network error occurred.\",\n },\n US_BANK_ACCOUNT_FAILED_TOKENIZATION: {\n type: BraintreeError.types.CUSTOMER,\n code: \"US_BANK_ACCOUNT_FAILED_TOKENIZATION\",\n message: \"The supplied data failed tokenization.\",\n },\n US_BANK_ACCOUNT_NOT_ENABLED: {\n type: BraintreeError.types.MERCHANT,\n code: \"US_BANK_ACCOUNT_NOT_ENABLED\",\n message: \"US bank account is not enabled.\",\n },\n US_BANK_ACCOUNT_BANK_LOGIN_NOT_ENABLED: {\n type: BraintreeError.types.MERCHANT,\n code: \"US_BANK_ACCOUNT_BANK_LOGIN_NOT_ENABLED\",\n message: \"Bank login is not enabled.\",\n },\n};\n\n},{\"../lib/braintree-error\":140}],226:[function(_dereq_,module,exports){\n\"use strict\";\n/**\n * @module braintree-web/us-bank-account\n * @description This module is for accepting payments of US bank accounts.\n */\n\nvar basicComponentVerification = _dereq_(\"../lib/basic-component-verification\");\nvar BraintreeError = _dereq_(\"../lib/braintree-error\");\nvar createDeferredClient = _dereq_(\"../lib/create-deferred-client\");\nvar createAssetsUrl = _dereq_(\"../lib/create-assets-url\");\nvar errors = _dereq_(\"./errors\");\nvar USBankAccount = _dereq_(\"./us-bank-account\");\nvar VERSION = \"3.115.0\";\nvar wrapPromise = _dereq_(\"@braintree/wrap-promise\");\n\n/**\n * @static\n * @function create\n * @param {object} options Creation options:\n * @param {Client} [options.client] A {@link Client} instance.\n * @param {string} [options.authorization] A tokenizationKey or clientToken. Can be used in place of `options.client`.\n * @param {callback} [callback] The second argument, `data`, is the {@link USBankAccount} instance. If no callback is provided, `create` returns a promise that resolves with the {@link USBankAccount} instance.\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n */\nfunction create(options) {\n var name = \"US Bank Account\";\n\n return basicComponentVerification\n .verify({\n name: name,\n client: options.client,\n authorization: options.authorization,\n })\n .then(function () {\n return createDeferredClient.create({\n authorization: options.authorization,\n client: options.client,\n debug: options.debug,\n assetsUrl: createAssetsUrl.create(options.authorization),\n name: name,\n });\n })\n .then(function (client) {\n var usBankAccount;\n\n options.client = client;\n\n usBankAccount =\n options.client.getConfiguration().gatewayConfiguration.usBankAccount;\n if (!usBankAccount) {\n return Promise.reject(\n new BraintreeError(errors.US_BANK_ACCOUNT_NOT_ENABLED)\n );\n }\n\n return new USBankAccount(options);\n });\n}\n\nmodule.exports = {\n create: wrapPromise(create),\n /**\n * @description The current version of the SDK, i.e. `{@pkg version}`.\n * @type {string}\n */\n VERSION: VERSION,\n};\n\n},{\"../lib/basic-component-verification\":138,\"../lib/braintree-error\":140,\"../lib/create-assets-url\":145,\"../lib/create-deferred-client\":147,\"./errors\":225,\"./us-bank-account\":227,\"@braintree/wrap-promise\":40}],227:[function(_dereq_,module,exports){\n\"use strict\";\n\nvar BraintreeError = _dereq_(\"../lib/braintree-error\");\nvar constants = _dereq_(\"./constants\");\nvar errors = _dereq_(\"./errors\");\nvar sharedErrors = _dereq_(\"../lib/errors\");\nvar analytics = _dereq_(\"../lib/analytics\");\nvar once = _dereq_(\"../lib/once\");\nvar convertMethodsToError = _dereq_(\"../lib/convert-methods-to-error\");\nvar methods = _dereq_(\"../lib/methods\");\nvar wrapPromise = _dereq_(\"@braintree/wrap-promise\");\n\nvar TOKENIZE_BANK_DETAILS_MUTATION = createGraphQLMutation(\"UsBankAccount\");\nvar TOKENIZE_BANK_LOGIN_MUTATION = createGraphQLMutation(\"UsBankLogin\");\n\n/**\n * @typedef {object} USBankAccount~tokenizePayload\n * @property {string} nonce The payment method nonce.\n * @property {string} type The payment method type, always `us_bank_account`.\n * @property {object} details Additional account details. Currently empty.\n */\n\n/**\n * @class\n * @param {object} options See {@link module:braintree-web/us-bank-account.create|us-bank-account.create}.\n * @classdesc This class represents a US Bank Account component. Instances of this class can tokenize raw bank details or present a bank login. You cannot use this constructor directly. Use {@link module:braintree-web/us-bank-account.create|braintree.us-bank-account.create} instead.\n */\nfunction USBankAccount(options) {\n this._client = options.client;\n\n this._isTokenizingBankLogin = false;\n\n analytics.sendEvent(this._client, \"usbankaccount.initialized\");\n}\n\n/**\n * Tokenizes bank information to return a payment method nonce. You can tokenize bank details by providing information like account and routing numbers. You can also tokenize with a bank login UI that prompts the customer to log into their bank account.\n * @public\n * @param {object} options All tokenization options for the US Bank Account component.\n * @param {string} options.mandateText A string for proof of customer authorization. For example, `'I authorize Braintree to debit my bank account on behalf of My Online Store.'`.\n * @param {object} [options.bankDetails] Bank detail information (such as account and routing numbers). `bankDetails` or `bankLogin` option must be provided.\n * @param {string} options.bankDetails.routingNumber The customer's bank routing number, such as `'307075259'`.\n * @param {string} options.bankDetails.accountNumber The customer's bank account number, such as `'999999999'`.\n * @param {string} options.bankDetails.accountType The customer's bank account type. Must be `'checking'` or `'savings'`.\n * @param {string} options.bankDetails.ownershipType The customer's bank account ownership type. Must be `'personal'` or `'business'`.\n * @param {string} [options.bankDetails.firstName] The customer's first name. Required when account ownership type is `personal`.\n * @param {string} [options.bankDetails.lastName] The customer's last name. Required when account ownership type is `personal`.\n * @param {string} [options.bankDetails.businessName] The customer's business name. Required when account ownership type is `business`.\n * @param {object} options.bankDetails.billingAddress The customer's billing address.\n * @param {string} options.bankDetails.billingAddress.streetAddress The street address for the customer's billing address, such as `'123 Fake St'`.\n * @param {string} [options.bankDetails.billingAddress.extendedAddress] The extended street address for the customer's billing address, such as `'Apartment B'`.\n * @param {string} options.bankDetails.billingAddress.locality The locality for the customer's billing address. This is typically a city, such as `'San Francisco'`.\n * @param {string} options.bankDetails.billingAddress.region The region for the customer's billing address. This is typically a state, such as `'CA'`.\n * @param {string} options.bankDetails.billingAddress.postalCode The postal code for the customer's billing address. This is typically a ZIP code, such as `'94119'`.\n * @param {object} [options.bankLogin] Bank login information. `bankLogin` or `bankDetails` option must be provided.\n * @param {string} options.bankLogin.displayName Display name for the bank login UI, such as `'My Store'`.\n * @param {string} options.bankLogin.ownershipType The customer's bank account ownership type. Must be `'personal'` or `'business'`.\n * @param {string} [options.bankLogin.firstName] The customer's first name. Required when account ownership type is `personal`.\n * @param {string} [options.bankLogin.lastName] The customer's last name. Required when account ownership type is `personal`.\n * @param {string} [options.bankLogin.businessName] The customer's business name. Required when account ownership type is `business`.\n * @param {object} options.bankLogin.billingAddress The customer's billing address.\n * @param {string} options.bankLogin.billingAddress.streetAddress The street address for the customer's billing address, such as `'123 Fake St'`.\n * @param {string} [options.bankLogin.billingAddress.extendedAddress] The extended street address for the customer's billing address, such as `'Apartment B'`.\n * @param {string} options.bankLogin.billingAddress.locality The locality for the customer's billing address. This is typically a city, such as `'San Francisco'`.\n * @param {string} options.bankLogin.billingAddress.region The region for the customer's billing address. This is typically a state, such as `'CA'`.\n * @param {string} options.bankLogin.billingAddress.postalCode The postal code for the customer's billing address. This is typically a ZIP code, such as `'94119'`.\n * @param {callback} [callback] The second argument, data, is a {@link USBankAccount~tokenizePayload|tokenizePayload}. If no callback is provided, `tokenize` returns a promise that resolves with {@link USBankAccount~tokenizePayload|tokenizePayload}.\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n * @example\n * data, is a {@link Venmo~tokenizePayload|tokenizePayload}. If no callback is provided, the method will return a Promise that resolves with a {@link Venmo~tokenizePayload|tokenizePayload}.\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n * @example\n * button.addEventListener('click', function () {\n * // Disable the button so that we don't attempt to open multiple popups.\n * button.setAttribute('disabled', 'disabled');\n *\n * // Because tokenize opens a new window, this must be called\n * // as a result of a user action, such as a button click.\n * venmoInstance.tokenize().then(function (payload) {\n * // Submit payload.nonce to your server\n * // Use payload.username to get the Venmo username and display any UI\n * }).catch(function (tokenizeError) {\n * // Handle flow errors or premature flow closure\n * switch (tokenizeErr.code) {\n * case 'VENMO_APP_CANCELED':\n * console.log('User canceled Venmo flow.');\n * break;\n * case 'VENMO_CANCELED':\n * console.log('User canceled Venmo, or Venmo app is not available.');\n * break;\n * default:\n * console.error('Error!', tokenizeErr);\n * }\n * }).then(function () {\n * button.removeAttribute('disabled');\n * });\n * });\n */\nVenmo.prototype.tokenize = function (options) {\n var self = this;\n var tokenizationPromise;\n\n options = options || {};\n\n if (this._tokenizationInProgress === true) {\n return Promise.reject(\n new BraintreeError(errors.VENMO_TOKENIZATION_REQUEST_ACTIVE)\n );\n }\n\n this._tokenizationInProgress = true;\n if (this._useDesktopQRFlow) {\n // for the desktop flow, we create a venmo payment\n // context and then present a qr code modal to the\n // customer and they will open up their venmo app\n // and scan it and approve the purchase on their\n // mobile device. The sdk will start polling\n // in order to determine when the status of the\n // payment context has updated and then pass the\n // resulting nonce back to the merchant.\n tokenizationPromise = this._tokenizeForDesktopQRFlow(options);\n } else if (this._useAllowDesktopWebLogin) {\n /**\n * For Desktop Web Login, we open a browser popup to allow for authorization. Once authorized, the redirect urls are used by Venmo, and we query the API for a payment context status update.\n *\n * - Payment context is created on initialization\n * - Popup is opened to Venmo login url.\n * - The payment is authorized or canceled, and the popup is closed\n * - Once the popup is closed, we query the API for a payment context status update\n *\n * This is an alternate, opt-in flow to be used the Desktop QR Flow is not desired for Pay with Venmo desktop experiences.\n */\n tokenizationPromise = this._tokenizeWebLoginWithRedirect();\n } else if (this._cannotHaveReturnUrls) {\n // in the manual return strategy, we create the payment\n // context on initialization, then continually poll once\n // the app switch begins until we get a response indiciating\n // the payment context was approved by the customer on the\n // Venmo app. The payment context response also includes a\n // nonce. There are 2 cases where we use the manual return\n // strategy:\n // 1. the sdk is instantiated in an iframe, because\n // the venmo app is unable to redirect automatically\n // when that is the case so we rely on the customer\n // to do a manual redirect and continunally poll for\n // updates on the payment context to get the nonce\n // 2. same deal for when `requireManualReturn` is configured\n tokenizationPromise = this._tokenizeForMobileWithManualReturn();\n } else {\n // the default mobile flow is to app switch to the\n // venmo app, and then have the venmo app switch\n // back to the page with the venmo nonce details\n // encoded into the hash portion of the url. If\n // `paymentMethodUsage` is provided when instantiating\n // the sdk, we also create a payment context and pass\n // the resource id to the Venmo app during the app switch.\n // Once we get a succesful return, we ping the payment\n // context query to get any additional data needed\n // to send back to the merchant.\n tokenizationPromise =\n this._tokenizeForMobileWithHashChangeListeners(options);\n }\n\n return tokenizationPromise\n .then(function (payload) {\n return self._createPromise\n .then(function (client) {\n return self._createVenmoPaymentContext(client);\n })\n .then(function () {\n self._tokenizationInProgress = false;\n\n return formatTokenizePayload(payload);\n });\n })\n .catch(function (err) {\n return self._createPromise\n .then(function (client) {\n // We create a new Payment Context because if the last one failed, then presumably we don't want to use it again.\n // On the first pass, we create the payment context at initialization, and since we used that first one we now need to create a new one\n // for the next time someone tries to tokenize.\n return self._createVenmoPaymentContext(client);\n })\n .then(function () {\n self._tokenizationInProgress = false;\n\n return Promise.reject(err);\n });\n });\n};\n\n/**\n * Cancels the venmo tokenization process\n *\n * @public\n * @function Venmo~cancelTokenization\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n * @example\n * venmoTokenizeButton.addEventListener('click', function () {\n * venmoInstance.tokenize().then(function (payload) {\n * // handle payload\n * }).catch(function (err) {\n * if (err.code === 'VENMO_TOKENIZATION_CANCELED_BY_MERCHANT') {\n * // tokenization was canceled by calling cancelTokenization\n * }\n * });\n * });\n *\n * venmoCancelButton.addEventListener('click', function () {\n * // Hide the button when the venmo flow is not in progress\n * venmoCancelButton.style.display = \"none\";\n *\n * venmoInstance.cancelTokenization().then(function () {\n * // done canceling the flow\n * }).catch(function (err) {\n * // should only get here if there is no tokenization in progress\n * });\n * });\n */\nVenmo.prototype.cancelTokenization = function () {\n if (!this._tokenizationInProgress) {\n return Promise.reject(\n new BraintreeError(errors.VENMO_TOKENIZATION_REQUEST_NOT_ACTIVE)\n );\n }\n\n this._removeVisibilityEventListener();\n\n // important to reject the tokenization promise first\n // so the tokenize method rejects with this error\n // rather than a customer canceled error in the mobile\n // polling and desktop flows\n if (this._tokenizePromise) {\n this._tokenizePromise.reject(\n new BraintreeError(errors.VENMO_TOKENIZATION_CANCELED_BY_MERCHANT)\n );\n }\n\n return Promise.all([\n this._cancelMobilePaymentContext(),\n this._cancelVenmoDesktopContext(),\n ]);\n};\n\nVenmo.prototype._tokenizeWebLoginWithRedirect = function () {\n var self = this;\n\n analytics.sendEvent(self._createPromise, \"venmo.tokenize.web-login.start\", {\n paypal_context_id: self._venmoPaymentContextId,\n });\n this._tokenizePromise = new ExtendedPromise();\n\n return this.getUrl().then(function (url) {\n desktopWebLogin\n .runWebLogin({\n checkForStatusChange:\n self._checkPaymentContextStatusAndProcessResult.bind(self),\n cancelTokenization: self.cancelTokenization.bind(self),\n frameServiceInstance: self._frameServiceInstance,\n venmoUrl: url,\n debug: self._isDebug,\n checkPaymentContextStatus: self._checkPaymentContextStatus.bind(self),\n })\n .then(function (payload) {\n analytics.sendEvent(\n self._createPromise,\n \"venmo.tokenize.web-login.success\",\n {\n paypal_context_id: self._venmoPaymentContextId,\n }\n );\n\n self._tokenizePromise.resolve({\n paymentMethodNonce: payload.paymentMethodId,\n username: payload.userName,\n payerInfo: payload.payerInfo,\n id: self._venmoPaymentContextId,\n });\n })\n .catch(function (err) {\n analytics.sendEvent(\n self._createPromise,\n \"venmo.tokenize.web-login.failure\",\n {\n paypal_context_id: self._venmoPaymentContextId,\n }\n );\n\n self._tokenizePromise.reject(err);\n });\n\n return self._tokenizePromise;\n });\n};\n\nVenmo.prototype._queryPaymentContextStatus = function (id) {\n var self = this;\n\n return this._createPromise\n .then(function (client) {\n var query = self._shouldUseLegacyFlow\n ? graphqlQueries.LEGACY_VENMO_PAYMENT_CONTEXT_STATUS_QUERY\n : graphqlQueries.VENMO_PAYMENT_CONTEXT_STATUS_QUERY;\n\n return client.request({\n api: \"graphQLApi\",\n data: {\n query: query,\n variables: {\n id: id,\n },\n },\n });\n })\n .then(function (response) {\n return response.data.node;\n });\n};\n\n/**\n * Queries the GraphQL API to get the payment context and process the status. Retries until there is an update to the payment context status.\n * @name Venmo~checkPaymentContextStatusAndProcessResult\n * @ignore\n * @param {number} retryCount The counter for tracking number of retries made against the API.\n * @returns {Promise} Returns a promise\n */\nVenmo.prototype._checkPaymentContextStatusAndProcessResult = function (\n retryCount\n) {\n var self = this;\n\n return self._checkPaymentContextStatus().then(function (node) {\n var resultStatus = node.status;\n\n if (resultStatus !== self._venmoPaymentContextStatus) {\n self._venmoPaymentContextStatus = resultStatus;\n\n analytics.sendEvent(\n self._createPromise,\n \"venmo.tokenize.web-login.status-change\",\n {\n paypal_context_id: self._venmoPaymentContextId,\n }\n );\n\n switch (resultStatus) {\n case \"APPROVED\":\n return Promise.resolve(node);\n case \"CANCELED\":\n return Promise.reject(\n new BraintreeError(errors.VENMO_CUSTOMER_CANCELED)\n );\n case \"FAILED\":\n return Promise.reject(\n new BraintreeError(errors.VENMO_TOKENIZATION_FAILED)\n );\n default:\n }\n }\n\n return new Promise(function (resolve, reject) {\n if (retryCount < self._maxRetryCount) {\n retryCount++;\n\n return self\n ._checkPaymentContextStatusAndProcessResult(retryCount)\n .then(resolve)\n .catch(reject);\n }\n\n return reject(new BraintreeError(errors.VENMO_TOKENIZATION_FAILED));\n });\n });\n};\n\nVenmo.prototype._checkPaymentContextStatus = function () {\n var self = this;\n\n return self\n ._queryPaymentContextStatus(self._venmoPaymentContextId)\n .catch(function (networkError) {\n return Promise.reject(\n new BraintreeError({\n type: errors.VENMO_NETWORK_ERROR.type,\n code: errors.VENMO_NETWORK_ERROR.code,\n message: errors.VENMO_NETWORK_ERROR.message,\n details: networkError,\n })\n );\n })\n .then(function (node) {\n return Promise.resolve(node);\n });\n};\n\nVenmo.prototype._pollForStatusChange = function () {\n var self = this;\n\n if (Date.now() > self._mobilePollingContextExpiresIn) {\n return Promise.reject(\n new BraintreeError(errors.VENMO_MOBILE_POLLING_TOKENIZATION_TIMEOUT)\n );\n }\n\n return this._queryPaymentContextStatus(this._venmoPaymentContextId)\n .catch(function (networkError) {\n return Promise.reject(\n new BraintreeError({\n type: errors.VENMO_MOBILE_POLLING_TOKENIZATION_NETWORK_ERROR.type,\n code: errors.VENMO_MOBILE_POLLING_TOKENIZATION_NETWORK_ERROR.code,\n message:\n errors.VENMO_MOBILE_POLLING_TOKENIZATION_NETWORK_ERROR.message,\n details: {\n originalError: networkError,\n },\n })\n );\n })\n .then(function (node) {\n var newStatus = node.status;\n\n if (newStatus !== self._venmoPaymentContextStatus) {\n self._venmoPaymentContextStatus = newStatus;\n\n analytics.sendEvent(\n self._createPromise,\n \"venmo.tokenize.manual-return.status-change.\" +\n newStatus.toLowerCase(),\n {\n paypal_context_id: self._venmoPaymentContextId,\n }\n );\n\n switch (newStatus) {\n case \"EXPIRED\":\n case \"FAILED\":\n case \"CANCELED\":\n return Promise.reject(\n new BraintreeError(\n errors[\"VENMO_MOBILE_POLLING_TOKENIZATION_\" + newStatus]\n )\n );\n case \"APPROVED\":\n return Promise.resolve(node);\n case \"CREATED\":\n case \"SCANNED\":\n default:\n // any other statuses are irrelevant to the polling\n // and can just be ignored\n }\n }\n\n return new Promise(function (resolve, reject) {\n setTimeout(function () {\n self._pollForStatusChange().then(resolve).catch(reject);\n }, self._mobilePollingInterval);\n });\n });\n};\n\nVenmo.prototype._tokenizeForMobileWithManualReturn = function () {\n var self = this;\n\n analytics.sendEvent(\n this._createPromise,\n \"venmo.tokenize.manual-return.start\",\n {\n paypal_context_id: self._venmoPaymentContextId,\n }\n );\n\n this._mobilePollingContextExpiresIn =\n Date.now() + this._mobilePollingExpiresThreshold;\n this._tokenizePromise = new ExtendedPromise();\n\n this._pollForStatusChange()\n .then(function (payload) {\n analytics.sendEvent(\n self._createPromise,\n \"venmo.tokenize.manual-return.success\",\n {\n paypal_context_id: self._venmoPaymentContextId,\n }\n );\n\n self._tokenizePromise.resolve({\n paymentMethodNonce: payload.paymentMethodId,\n username: payload.userName,\n payerInfo: payload.payerInfo,\n id: self._venmoPaymentContextId,\n });\n })\n .catch(function (err) {\n analytics.sendEvent(\n self._createPromise,\n \"venmo.tokenize.manual-return.failure\",\n {\n paypal_context_id: self._venmoPaymentContextId,\n }\n );\n\n self._tokenizePromise.reject(err);\n });\n\n return this.getUrl().then(function (url) {\n self.appSwitch(url);\n\n return self._tokenizePromise;\n });\n};\n\nVenmo.prototype._shouldUseRedirectStrategy = function () {\n if (!browserDetection.isIos()) {\n return false;\n }\n\n if (this._mobileWebFallBack === true) {\n return true;\n }\n\n return this._useRedirectForIOS;\n};\n\nVenmo.prototype._tokenizeForMobileWithHashChangeListeners = function (options) {\n var self = this;\n var resultProcessingInProgress, visibilityChangeListenerTimeout;\n\n if (this.hasTokenizationResult()) {\n return this.processHashChangeFlowResults();\n }\n\n analytics.sendEvent(this._createPromise, \"venmo.tokenize.mobile.start\");\n this._tokenizePromise = new ExtendedPromise();\n\n this._previousHash = window.location.hash;\n\n function completeFlow(hash) {\n var error;\n\n self\n .processHashChangeFlowResults(hash)\n .catch(function (err) {\n error = err;\n })\n .then(function (res) {\n if (\n !self._ignoreHistoryChanges &&\n window.location.hash !== self._previousHash\n ) {\n window.location.hash = self._previousHash;\n }\n self._removeVisibilityEventListener();\n\n if (error) {\n self._tokenizePromise.reject(error);\n } else {\n self._tokenizePromise.resolve(res);\n }\n delete self._tokenizePromise;\n });\n }\n\n // The Venmo SDK app switches back with the results of the\n // tokenization encoded in the hash\n this._onHashChangeListener = function (e) {\n var hash = e.newURL.split(\"#\")[1];\n\n if (!self._hasTokenizationResult(hash)) {\n return;\n }\n\n resultProcessingInProgress = true;\n clearTimeout(visibilityChangeListenerTimeout);\n completeFlow(hash);\n };\n\n window.addEventListener(\"hashchange\", this._onHashChangeListener, false);\n\n // Subscribe to document visibility change events to detect when app switch\n // has returned. Acts as a fallback for the hashchange listener and catches\n // the cancel case via manual app switch back\n this._visibilityChangeListener = function () {\n var delay =\n options.processResultsDelay || constants.DEFAULT_PROCESS_RESULTS_DELAY;\n\n if (!window.document.hidden) {\n if (!resultProcessingInProgress) {\n visibilityChangeListenerTimeout = setTimeout(completeFlow, delay);\n }\n }\n };\n\n return this.getUrl().then(function (url) {\n self.appSwitch(url);\n\n // Add a brief delay to ignore visibility change events that occur right before app switch\n setTimeout(function () {\n window.document.addEventListener(\n documentVisibilityChangeEventName(),\n self._visibilityChangeListener\n );\n }, constants.DOCUMENT_VISIBILITY_CHANGE_EVENT_DELAY);\n\n return self._tokenizePromise;\n });\n};\n\nVenmo.prototype._tokenizeForDesktopQRFlow = function () {\n var self = this;\n\n analytics.sendEvent(this._createPromise, \"venmo.tokenize.desktop.start\");\n\n this._tokenizePromise = new ExtendedPromise();\n\n this._createPromise\n .then(function () {\n return self._venmoDesktopInstance.launchDesktopFlow();\n })\n .then(function (payload) {\n self._venmoDesktopInstance.hideDesktopFlow();\n\n analytics.sendEvent(\n self._createPromise,\n \"venmo.tokenize.desktop.success\"\n );\n\n self._tokenizePromise.resolve(payload);\n })\n .catch(function (err) {\n analytics.sendEvent(\n self._createPromise,\n \"venmo.tokenize.desktop.failure\"\n );\n\n if (self._venmoDesktopInstance) {\n self._venmoDesktopInstance.hideDesktopFlow();\n }\n\n if (err && err.reason === \"CUSTOMER_CANCELED\") {\n self._tokenizePromise.reject(\n new BraintreeError(errors.VENMO_DESKTOP_CANCELED)\n );\n\n return;\n }\n\n self._tokenizePromise.reject(\n new BraintreeError({\n type: errors.VENMO_DESKTOP_UNKNOWN_ERROR.type,\n code: errors.VENMO_DESKTOP_UNKNOWN_ERROR.code,\n message: errors.VENMO_DESKTOP_UNKNOWN_ERROR.message,\n details: {\n originalError: err,\n },\n })\n );\n });\n\n return this._tokenizePromise;\n};\n\nVenmo.prototype._cancelMobilePaymentContext = function () {\n var self = this;\n\n return this._createPromise.then(function (client) {\n var query;\n\n if (self._venmoPaymentContextId) {\n query = self._shouldUseLegacyFlow\n ? graphqlQueries.LEGACY_UPDATE_PAYMENT_CONTEXT_QUERY\n : graphqlQueries.UPDATE_PAYMENT_CONTEXT_QUERY;\n\n return client.request({\n api: \"graphQLApi\",\n data: {\n query: query,\n variables: {\n input: {\n id: self._venmoPaymentContextId,\n status: \"CANCELED\",\n },\n },\n },\n });\n }\n\n return Promise.resolve();\n });\n};\n\nVenmo.prototype._cancelVenmoDesktopContext = function () {\n var self = this;\n\n return this._createPromise.then(function () {\n if (self._venmoDesktopInstance) {\n self._venmoDesktopInstance.updateVenmoDesktopPaymentContext(\"CANCELED\");\n }\n\n return Promise.resolve();\n });\n};\n\n/**\n * Cleanly tear down anything set up by {@link module:braintree-web/venmo.create|create}.\n * @public\n * @param {callback} [callback] Called once teardown is complete. No data is returned if teardown completes successfully.\n * @example\n * venmoInstance.teardown();\n * @example tokenizePayload is a {@link VisaCheckout~tokenizePayload|tokenizePayload}. If no callback is provided, `tokenize` returns a promise that resolves with the {@link VisaCheckout~tokenizePayload|tokenizePayload}.\n * @returns {(Promise|void)} Returns a promise if no callback is provided.\n */\nVisaCheckout.prototype.tokenize = function (payment) {\n var self = this;\n\n if (!payment.callid || !payment.encKey || !payment.encPaymentData) {\n return Promise.reject(\n new BraintreeError(errors.VISA_CHECKOUT_PAYMENT_REQUIRED)\n );\n }\n\n return this._client\n .request({\n method: \"post\",\n endpoint: \"payment_methods/visa_checkout_cards\",\n data: {\n _meta: {\n source: \"visa-checkout\",\n },\n visaCheckoutCard: {\n callId: payment.callid,\n encryptedPaymentData: payment.encPaymentData,\n encryptedKey: payment.encKey,\n },\n },\n })\n .then(function (response) {\n analytics.sendEvent(self._client, \"visacheckout.tokenize.succeeded\");\n\n return response.visaCheckoutCards[0];\n })\n .catch(function (err) {\n analytics.sendEvent(self._client, \"visacheckout.tokenize.failed\");\n\n return Promise.reject(\n new BraintreeError({\n type: errors.VISA_CHECKOUT_TOKENIZATION.type,\n code: errors.VISA_CHECKOUT_TOKENIZATION.code,\n message: errors.VISA_CHECKOUT_TOKENIZATION.message,\n details: {\n originalError: err,\n },\n })\n );\n });\n};\n\n/**\n * Cleanly tear down anything set up by {@link module:braintree-web/visa-checkout.create|create}.\n * @public\n * @param {callback} [callback] Called once teardown is complete. No data is returned if teardown completes successfully.\n * @example\n * visaCheckoutInstance.teardown();\n * @example