Something Went Wrong Creating the Braintree Credential. Try Again.

Overview ↑ Back to top

Braintree for WooCommerce (formerly PayPal Powered past Braintree)lets you lot accept credit cards and PayPal payments on your WooCommerce shop via Braintree. Customers tin can save their credit card details or link a PayPal account to their WooCommerce user account for fast and easy checkout.

Braintree for WooCommerce includes full back up for WooCommerce Subscriptions and WooCommerce Pre-Orders for both the credit card and PayPal gateways! Click here for more information about Subscriptions and Pre-Orders compatibility.

Translation prepare! This plugin uses two text domains:

• woocommerce-gateway-paypal-powered-past-braintree
• woocommerce-plugin-framework

Click here for translation help.

Requirements ↑ Back to top

• PHP 5.4+ (you can see this under WooCommerce > Status)
• WooCommerce 2.6+
• An SSL certificate
• A Braintree Direct business relationship
• gyre support (almost hosts accept this enabled by default)

As of version 2.0, Braintree for WooCommerce can be used with merchant accounts in any land. However, your store currency must match your merchant account! If yous'd like to sell in a different currency than your Braintree account, you lot must use a multi-currency setup.

Installation ↑ Back to top

1. Ensure your shop meets the plugin requirements.
2. Download the extension from your WooCommerce dashboard.
3. Go to Plugins > Add together New > Upload and select the Aught file yous just downloaded.
4. Click Install Now and and so Activate.
5. Click Configure and read the next section to larn how to setup the plugin.

Getting started ↑ Back to top

Follow the steps beneath to connect the plugin to your Braintree Directly business relationship:

1. Login to your Braintree Control Panel.
2. Select the gear icon in the upper right corner and click API.

1. From here, you tin can click View to view an existing set up of API keys or Generate New API Fundamental to create a new gear up.

1. When viewing keys, copy the Public Central, Individual Primal, and Merchant ID.

1. Now, login to your WooCommerce site and go to WooCommerce > Settings > Payments and select either of the Braintree gateways.
2. Paste the copied API keys into the associated fields under the Connexion Settings.
3. Click Save changes.

That's it! You lot're ready to start accepting payments. Keep reading if you lot want to tweak settings and customize the checkout process.

Credit card settings ↑ Back to top

You tin configure the following settings for the Braintree for WooCommerce credit carte du jour gateway:

• Enable / Disable: Allow customers to use this gateway to checkout.
• Title: The text shown for the payment during checkout and on the Order Received page.
• Description: The text shown under the gateway's championship during checkout. Express HTML is allowed. If you enable exam fashion, this section will also brandish a detect along with exam credit card numbers.
• Carte Verification (CSC): Require customers to enter their card security codes when checking out.
• Transaction Blazon: Controls how transactions are submitted to Authorize.Net. Defaults to "Accuse" to automatically capture payments. Click here to learn more about capturing payments.
• Accuse Virtual-Only Orders: If Transaction Type is set to "Authorization", enable this to automatically capture charges for orders with only virtual products. For downloadable products, this will grant downloads access correct away.
• Capture Paid Orders: If Transaction Blazon is set to "Authorization", enable this to automatically capture charges when orders move to a paid condition.
• Accustomed Card Logos: Determines which card logos are displayed during checkout. This has no touch on on which cards are accustomed by your merchant business relationship.
• Tokenization: Allow customers relieve their payment methods for futurity use at checkout. The Vault must exist enabled in your Braintree account to use tokenization. This is required for Subscriptions or Pre-Orders.
• Detailed Reject Letters: Display detailed messages to customers to provide reasoning for declines instead of a generic fault message when possible. Click here to read more near detailed reject messages.
• Debug Fashion: Enable when you're having problems processing transactions. You can choose to log API requests directly on the checkout page, save them to the WooCommerce > Status > Logs page, or both. Equally a best practice, delight do not enable this setting unless y'all're having bug with the plugin.
• Environment: Switch betwixt "Production" and "Sandbox" credentials. Set to "Production" to procedure payments. Enable "Sandbox" to transport transactions to your Braintree sandbox business relationship. Click here to sign up for a Braintree sandbox account.
• Share connexion settings: If using the credit menu and PayPal gateways, select this setting to share credentials between the gateways and then yous don't have to enter them twice.
• Merchant ID, Public Fundamental, Individual Key: API primal credentials required to connect the plugin to Braintree. Click hither for instructions on locating those keys.
• Merchant Account IDs: Use if yous have dissimilar merchant accounts for multi-currency support. Click hither to read more about Braintree multi-currency.
• Dynamic Descriptors: Determine how your shop is represented on customer credit card statements. Click here to read more almost dynamic descriptors.
• Fraud Settings: Optionally select the fraud tool you'd like to utilize for your payments. Click hither to read more about fraud and verification tools.
• 3D Secure: Optionally enable unlike 3D secure verifications if enabled under your Braintree account. Click here to read more about 3D secure.

PayPal settings ↑ Back to top

To utilise the Braintree PayPal gateway, you must take PayPal enabled in your Braintree account under Settings > Processing.

If y'all want to apply PayPal without credit carte processing, click hither to read more virtually configuring this correctly.

You lot can configure the post-obit settings for the Braintree for WooCommerce PayPal gateway:

• Enable / Disable: Let customers to use this gateway to checkout.
• Championship: The text shown for the payment during checkout and on the Order Received page.
• Clarification: The text shown nether the gateway's championship during checkout. Limited HTML is immune.
• Button Colour: Choose the color of the "Pay with PayPal" push. You can see how this will await nether the Preview section.
• Push button Size: Choose the size of the "Pay with PayPal" push. You can see how this will look under the Preview section.
• Button Shape: Choose the shape of the "Pay with PayPal" push button. You can see how this volition expect under the Preview section.
• PayPal Credit: For U.s.a. merchants, enable the PayPal Credit button beneath the standard "Pay with PayPal" button.
• Purchase At present on Product Pages: Enable to add the "PayPal Buy At present" button on product pages. Click here to read more near this express checkout option.
• Enable Cart Checkout: Enable to allow customers to checkout with PayPal from the Cart. Click here to read more almost this express checkout option.
• Transaction Type: Controls how transactions are submitted to Qualify.Net. Defaults to "Charge" to automatically capture payments. Click here to learn more near capturing payments.
• Charge Virtual-Just Orders: If Transaction Type is set up to "Authorization", enable this to automatically capture charges for orders with only virtual products. For downloadable products, this volition grant downloads access right away.
• Capture Paid Orders: If Transaction Type is prepare to "Potency", enable this to automatically capture charges when orders motility to a paid status.
• Tokenization: Let customers link their PayPal account for future use at checkout. Requires Advanced Fraud Tools to be enabled on your Braintree account. Click hither to larn more virtually fraud tools and setup. This is required for Subscriptions or Pre-Orders.
• Detailed Reject Messages: Display detailed letters to customers to provide reasoning for declines instead of a generic error message when possible. Click here to read more about detailed decline messages.
• Debug Way: Enable when yous're having issues processing transactions. You can choose to log API requests straight on the checkout page, save them to the WooCommerce > Status > Logs folio, or both. As a best practise, please exercise non enable this setting unless you're having issues with the plugin.
• Environment: Switch between "Product" and "Sandbox" credentials. Set to "Production" to procedure payments. Enable "Sandbox" to send transactions to your Braintree sandbox account. Click hither to sign upward for a Braintree sandbox business relationship.
• Share connection settings: If using the credit carte and PayPal gateways, select this setting to share credentials between the gateways so you don't accept to enter them twice.
• Merchant ID, Public Key, Private Central: API fundamental credentials required to connect the plugin to Braintree. Click here for instructions on locating those keys.
• Merchant Account IDs: Utilise if you lot have different merchant accounts for multi-currency support. Click hither to read more about Braintree multi-currency.
• Dynamic Descriptors: Determine how your shop is represented on customer credit card statements. Click here to read more most dynamic descriptors.

Multi-currency setup ↑ Back to summit

If yous want to take payments in multiple currencies, you lot tin add credentials for dissimilar merchant accounts. When used aslope a currency switcher plugin, you can then route payments to the dissimilar accounts based on the currency. Nosotros recommend these plugins to enable multi-currency in your WooCommerce shop:

• WooCommerce Multi-Currency (requires buy)
• Aelia Currency Switcher (requires purchase)

Both plugins piece of work seamlessly with Braintree for WooCommerce.

Follow the steps below to add more merchant accounts to accept multi-currency payments:

• Install and activate a currency switcher plugin, such as Aelia Currency Switcher.
• Become to WooCommerce > Settings > Payments and select the Braintree gateway yous want to update.
• Nether the Merchant Business relationship IDs section, select the currency for this merchant business relationship from the drop-down bill of fare and click Add together merchant account ID.
• Enter the merchant account ID in the newly created field.
• Echo steps three and 4 equally needed for each currency / merchant ID.
• Click Save changes.

Dynamic Descriptors setup ↑ Dorsum to top

Dynamic Descriptors let you control how your charges announced on customer credit carte du jour statements for specific purchases. This can help you avoid customer disputes / chargebacks due to confusion or non-recognition. Dynamic Descriptors must be enabled by your Braintree representative.

Braintree has very specific formatting requirements for these fields, then we highly recommend running a exam transaction to ostend your format is valid.

Once enabled by Braintree, you can configure Dynamic Descriptors in the gateway settings. There are iii format options for the Proper name field – please note that components must be separated by an asterisk:

• [iii letters]*[upwards to xviii letters]: iii letters to correspond the company proper noun, up to xviii letters to correspond the product name. For case, SKY*WOOCOMMERCEPLUGINS.

3*18 format

• [7 letters]*[up to xiv letters]: vii letters to correspond the visitor name, up to 14 messages to represent the product name. For example, SKYVERGE*WOOCOMMPLUGINS.

7*14 format

• [12 letters]*[up to nine messages]: 12 messages to represent the company name, upwardly to nine letters to represent the product proper noun. For case, SKYVERGECORP*WCPLUGINS.

12*ix format

For the Phone field (optional), you must enter exactly ten characters. This field can just contain numbers, dashes, parentheses, or periods.

For the URL field (optional), y'all may enter your URL in 13 characters or less.

Fraud and verification tools ↑ Back to top

Past default, Braintree includes Bones fraud verification tools. All the same, at that place are more sophisticated fraud prevention tools – Advanced or Kount Direct – which you tin can optionally enable through your Braintree account.

We recommend enabling Advanced fraud tools, since they provide additional protection and are hands enabled. Click here to read more about the available fraud tools.

Notation: If you want to use tokenization with PayPal and support Subscriptions / Pre-Orders, y'all must enable Fraud Protection Avant-garde to do then.

To turn on Fraud Protection Advanced, login to your Braintree account, go to Settings > Fraud Management and enable Fraud Protection Advanced. You can and then update the gateway settings.

To enable Kount Direct fraud tools, contact your Braintree representative. They can provide the Kount Merchant ID required in the gateway settings.

3D Secure

If you lot'd like to use 3D Secure verification tools similar Verified by Visa, you lot must first contact your Braintree representative. You can and then configure 3D Secure in the payment gateway settings with ii fields:

• Level: Choose "Standard" to accept any payments non explicitly rejected during verification, or "Strict" to simply take payments that explicitly pass. If set to "Strict", failures caused due to connection / availability errors will be rejected as well.
• Supported Card Types: Decide which carte types 3D Secure validation should apply to.

Using PayPal without credit cards ↑ Back to superlative

If you'd similar to apply PayPal without credit cards, you'll need to pay careful attending to a few settings to ensure everything is configured correctly. You lot have ii options for how to set up this upwardly, based on whether y'all want to allow customers to link their PayPal account for future purchases.

Using PayPal for onetime purchases

You can allow customers employ Checkout with PayPal for ane-time purchases without configuring anything for the Braintree credit bill of fare gateway, and get out the credit menu gateway disabled. However, you cannot enable tokenization with this setup, so customers can't link their PayPal business relationship to WooCommerce for future purchases.

This setup is not compatible with Subscriptions or Pre-Orders – tokenization is required for using Subscriptions.

Using PayPal with linked accounts

Past using the Checkout with PayPal and PayPal Vault workflows, y'all tin can let your customers link their PayPal accounts to your shop for faster hereafter purchases and for Subscriptions / Pre-Orders back up.

This requires a flake of extra setup since Braintree requires using Advanced Fraud Tools with the PayPal Vault. Instead of setting upwardly everything simply in the Braintree PayPal gateway settings, follow the steps below:

1. Go to WooCommerce > Settings > Payments and select the Braintree (Credit Carte) gateway. You can leave this gateway disabled to hide it at checkout.
2. Enter your API keys under the Connectedness Settings.
3. Configure the Fraud Tool setting to "Advanced". Click here for instructions on ensuring advanced fraud tools are enabled for your Braintree account.
4. Click Save changes.
5. Click Payments and select the Braintree (PayPal) gateway and configure the following settings:
   • Enable the gateway.
   • Enable Share connection settings.
   • Enable Tokenization.
6. Click Save changes.

This ensures that advanced fraud tools are bachelor so you tin use the PayPal Vault.

If you're using this setup, please contact u.s. and let us know! If this is a pop style of configuring Braintree for WooCommerce, we'd similar to make this setup process easier.

Support Apple Pay ↑ Dorsum to acme

You tin can back up Apple Pay payments with Braintree for WooCommerce with some additional configuration steps.

1. Follow these instructions to enable Apple Pay in your Braintree business relationship.
2. Next, follow these instructions to register your domain for Apple tree Pay.
3. Y'all may then enable Apple Pay on your site past going to WooCommerce > Settings > Payments > Apple tree Pay.

Please notation that the Apple Pay integration with Braintree does not support Variable Products.

Managing orders ↑ Back to top

As a site administrator, you lot can use the Braintree for WooCommerce gateway to manually capture charges and automatically refund / void transactions as needed.

Capture charges ↑ Back to acme

If the gateway's Transaction Type is configured to "Potency", you can manually capture these payments from the WooCommerce Orders page. Click here to read more about capturing charges.

Automatic refunds ↑ Back to top

You tin process refunds for both the credit card and PayPal gateways directly in WooCommerce without needing to log into your Braintree control panel. Click here to read more than about issuing automatic refunds from WooCommerce.

Void transactions ↑ Back to top

Y'all can void transactions directly in WooCommerce in the following circumstances:

• If the Transaction Type is set to "Authorization", you can void when the transaction has been authorized just not yet captured.
• If the Transaction Type is set to "Charge", you can void when the transaction has not yet been settled (i.e. funds haven't been transferred from the customer's account to your Braintree account).

Braintree does not have fractional voids. If a transaction is no longer eligible to be voided, you must refund the lodge. Click here to read more almost voiding transactions in WooCommerce.

Gateway features ↑ Back to peak

Your customers can take advantage of the post-obit features when your site uses Braintree for WooCommerce.

Express checkout ↑ Dorsum to pinnacle

Braintree for WooCommerce offers a few tools to aid expedite PayPal checkout for your customers – Cart Checkout and Buy At present buttons.

When the Enable Cart Checkout setting is enabled, a PayPal Checkout option will be offered on the cart page. This lets customers log into PayPal, prepare account details, and proceed to checkout with these details prefilled in the billing / shipping sections – all they need to do is click Place order to consummate the buy.

Note: This option isn't shown if the customer has a saved payment method linked to their WooCommerce site account, so they tin can use this saved account data instead of overriding with the PayPal account details.

When the Buy Now on Production Pages setting is enabled, a Buy At present button is displayed on product pages, which lets customers make purchases via PayPal without going through the standard cart / checkout menstruation.

Saved payment methods ↑ Back to meridian

When Tokenization is enabled, customers can save payment methods during the checkout process or from their My Account area. This lets them apace save payment details or link their PayPal account for faster future purchases and also lets your site support Subscriptions and Pre-Orders. Click here to read more about managing saved payment methods.

Frequently Asked Questions ↑ Back to top

Does Braintree for WooCommerce work with WooCommerce Subscriptions or WooCommerce Pre-Orders? ↑ Back to top

Aye! Both the credit card and PayPal gateways include total Subscriptions and Pre-Orders support. Please note that in gild to use these plugins with Braintree, you must:

• Accept the Braintree vault enabled in your Braintree business relationship for credit card transactions
• Have the PayPal Vault enabled for PayPal transactions
• Enable the Tokenization setting for the credit card and / or PayPal gateways
• For PayPal transactions, enable Advanced Fraud Tools in your Braintree business relationship and configure that in the PayPal gateway settings

Why don't my subscriptions brandish inside the Braintree control panel? ↑ Dorsum to meridian

Braintree for WooCommerce doesn't use Braintree's subscription handling – instead, information technology tokenizes the customer's payment method and then lets the Subscriptions plugin handle charging the payment method. This is a far more flexible method and supports many features not provided through Braintree's command panels, such as irresolute payment dates and amounts.

How does Braintree for WooCommerce bear upon my site's PCI compliance? ↑ Back to top

Braintree for WooCommerce is PCI DSS v3.0 SAQ-A compliant and uses Braintree'southward hosted fields to process payments. Sensitive payment data is never passed through your site server, equally it's tokenized client-side before it's sent to Braintree. The hosted fields aren't quite the same as Braintree's v.zero SDK, but works in a similar way and are only as secure. We use hosted fields since it offers better customization options for the payment class, letting you create a more intuitive checkout.

My credentials are correct, merely I still don't see PayPal at checkout. What'due south going on? ↑ Back to peak

To use PayPal, y'all'll outset need to enable PayPal in your Braintree account – login to your account, become to Settings > Processing, and enable the PayPal payment method.

Why exercise I see a "customer with id xxxxxxxx not found" error at checkout? ↑ Back to top

If you've recently switched Braintree accounts (east.g. from Sandbox to Production), y'all'll need to clear the Braintree customer ID in the user's contour on the Users page.

How do I use Braintree'southward Address Verification System (AVS) with this plugin? ↑ Dorsum to superlative

You can enable AVS in your Braintree business relationship. Click here for instructions.

What countries can I use Braintree for WooCommerce in? ↑ Dorsum to meridian

Yous can apply Braintree for WooCommerce in any state where Braintree accounts are available!

I set upwardly the gateway with my different merchant accounts, just processing is notwithstanding going through a single account. What's gone wrong? ↑ Back to top

This plugin tin switch accounts based on payment currency, but it can't handle switching the currency itself. If you want to use multiple currencies, we recommend using Aelia Currency Switcher or WooCommerce Multi-Currency since they're uniform with Braintree for WooCommerce – the gateway will then handle routing the payments based on their selected currency. Click here to read more about accepting multiple currencies with Braintree for WooCommerce.

Does Braintree support Venmo or Apple Pay? ↑ Back to acme

Venmo is mobile-only, which means information technology's non available for eCommerce / website payments. Apple Pay is supported as of version ii.2.0! Click hither to acquire more nearly using Apple Pay.

Troubleshooting ↑ Dorsum to top

Having a problem? Follow these steps to make sure everything is set up correctly:

• Delight ensure that your site meets the plugin requirements.
• Cheque the FAQs to see if they accost your question.
• Confirm that your API credentials are correct.
• Confirm that y'all're non using production API credentials when the gateway's Environment is set to "Sandbox" (or vice versa).
• Enable Debug Mode and review the errors codes/messages provided by Braintree under WooCommerce > Status > Logs. In some cases, such as a transaction existence held for review or declined, the plugin cannot change the outcome and it must be resolved in your Braintree business relationship. If the error code indicates an upshot with the plugin, please submit a support ticket and include the logs to help us troubleshoot.

Theme issues ↑ Dorsum to top

Braintree for WooCommerce loads of import JavaScript on the checkout folio. Some themes (particularly those based on the Starker base theme) cause conflicts with this JavaScript. There are ii chief problems:

• The theme lacks the do_action ( 'get_header' ); call when loading the checkout page. The Starker theme (and any kid themes) is an example of this issue. This action must exist added to the theme, or we recommend using a WooCommerce-compatible theme like Storefront instead.
• The theme has incorrectly modified the review-order.php template. The Braintree javascript requires the order review div to accept the order_review class. When a theme has modified the template and inverse or removed that div, this trigger can't exist bound and you lot'll come across errors. To gear up this, ensure that your review-order.php template is up-to-date and hasn't been incorrectly modified.

Questions and Support

Do you still accept questions and need help?

• Get in bear upon with a Happiness Engineer via our Assistance Desk. We provide support for extensions developed by and/or sold on WooCommerce.com, and Jetpack/WordPress.com customers.
• If you are not a customer, we recommend finding assistance on the WooCommerce Support Forum or hiring a recommended expert on our customizations folio.

williamssupost.blogspot.com

Source: https://woocommerce.com/document/woocommerce-gateway-paypal-powered-by-braintree/

Share this post