PayPal Braintree: INSTANTIATION_OPTION_REQUIRED when clientToken missing (cart PayPal button)

[Genaker]

Summary

PayPal_Braintree/js/paypal/button.js calls braintree.create({ authorization: buttonConfig.clientToken }) in loadSDK without validating clientToken. When the token is missing (failed generation, misconfiguration, or edge cases), the Braintree JS SDK throws:

• Code: INSTANTIATION_OPTION_REQUIRED
• Message: options.authorization is required when instantiating a client.
• Console: paypalCheckout error (logged at the clientErr handler).

express-paypal.js already guards with if (!this.clientToken) { return; } before initializing PayPal buttons; the shared cart/minicart button.js path does not.

Package

Composer: paypal/module-braintree-core (module PayPal_Braintree).
File: view/frontend/web/js/paypal/button.js — method loadSDK.

Suggested fix

At the start of loadSDK, return early when !buttonConfig || !buttonConfig.clientToken, consistent with express-paypal.js initPayPalButtons.

Notes

Merchants should still fix root causes (Braintree credentials, token generation) when the token is routinely empty; the guard prevents a hard client-side error and matches existing patterns in the same integration.

---

Related: quality-patches PR (vendor patch) to follow.

[m2-assistant]

Hi @Genaker. Thank you for your report.
To speed up processing of this issue, make sure that the issue is reproducible on the vanilla Magento instance following Steps to reproduce.

• For more details, review the Magento Contributor Assistant documentation.
• Add a comment to assign the issue: @magento I am working on this
• To learn more about issue processing workflow, refer to the Code Contributions.

---

Join Magento Community Engineering Slack and ask your questions in #github channel.
⚠️ According to the Magento Contribution requirements, all issues must go through the Community Contributions Triage process. Community Contributions Triage is a public meeting.
🕙 You can find the schedule on the Magento Community Calendar page.
📞 The triage of issues happens in the queue order. If you want to speed up the delivery of your contribution, join the Community Contributions Triage session to discuss the appropriate ticket.

[Genaker]

Community Quality Patches PR (vendor patch for paypal/module-braintree-core button.js): magento/quality-patches#159

The Braintree package is distributed via Composer (repo.magento.com), not the magento/magento2 tree; this follows the same approach as other Braintree fixes in quality-patches (e.g. BUNDLE patches under vendor/paypal/module-braintree-core/).