In order to start accepting PayPal with Braintree, you’ll need to:
- have a compatible Braintree account
- have a free, verified PayPal Business Account
- enter your PayPal credentials in the Braintree Control Panel
You'll also need to integrate with Braintree and add PayPal as a payment method. See our PayPal guide in the developer docs.
You can test your PayPal integration in the Braintree sandbox environment in 2 ways: using the default mocked PayPal testing setup, or by linking your PayPal sandbox to your Braintree sandbox for end-to-end testing. See our developer docs for details on testing PayPal transactions.
- Log into the PayPal console
- Click Profile near the top of the page
- Click My Personal Info
- Click Update near Business Information
- Click Upgrade
- Select a business type and click Continue
- Enter your business information and follow the remaining prompts
In order to avoid withdrawal limits or the inability to process transactions, you will need to verify specific information, like your bank account.
You must enter your PayPal Business Account credentials in the Braintree Control Panel to enable PayPal in production. You can only link one PayPal account to your Braintree gateway.
- Log into the Control Panel
- Navigate to Settings > Processing > PayPal
- Click the toggle to access the Accept PayPal options page
- Click on the PayPal button
- Enter your PayPal login credentials and click Log In
- Make sure the use new vault flow box is checked
- Click Submit
We will send you an email to confirm that you have successfully logged into PayPal in your Braintree Control Panel and let you know if there are any next steps. Once you’ve been approved to process PayPal transactions, you will be notified via email. The approval process typically takes 1-2 business days.
Once you have successfully linked your PayPal Business Account to your Braintree Control Panel, you may notice that a REST API app has been created in your PayPal Apps Control Panel. This app allows Braintree to interact with the PayPal API on your behalf – without it, you will be unable to process PayPal transactions through your Braintree account. We recommend that you do not delete the REST API app at any time. Contact our Support team for more information.
To keep funding as simple as possible, we recommend that you enable Settlement Withdrawal on your account by contacting PayPal. Read more about Settlement withdrawal, funding, and reconciliation.
An eCheck, or electronic check, is a payment sent directly from your customer's bank account. Braintree does not support these transactions at this time. If your PayPal account allows for eCheck payment attempts, the authorization may be successful, but the transaction will be automatically voided.
eCheck payments can be blocked before the authorization, which provides a better experience for your customers. To block eCheck payments, adjust your payment receiving preferences.
When you create a PayPal transaction, the customer will be charged in the currency associated with your Braintree merchant account. PayPal supports many currencies, so even if the customer's PayPal account is in a different currency, they can usually still purchase from you. However, PayPal may assess a conversion fee and a cross-border fee, depending on your account setup. If you'd like to avoid these fees, you can adjust your payment receiving preferences to block all payments in foreign currencies.
If many of your customers are international and you want to accept PayPal payments in multiple currencies, contact our Accounts team to discuss setup options.
Many account changes can be made directly in your PayPal console (e.g. your funding bank account), but you may need to call to request certain setup options (e.g. Settlement Withdrawal). For the fastest service via phone, it’s best to log into your PayPal account, click Help, and then click Call us. This will give you a passcode, which you can provide to PayPal to immediately verify your identity when you call. Passcodes expire in 60 minutes.
To send an email instead, log into your PayPal account, click Help, and then click Email us.
Still have questions?
If you can’t find an answer, contact our Support team.