Braintree Linnworks Integration User Manual

External image


The Braintree Integration for Linnworks allows payments to be collected for any Linnworks unpaid direct orders either locally in store or remotely via with the Braintree Payments: an all-in-one payments solution


Braintree Documentation

Step 1: Introduction:

The Braintree connector is an application which is embedded into Linnworks, and developed and supported by eBusiness Guru.

It can be used to take payments for Direct Orders in Linnworks. Customers can also check how many payments have been made via Braintree.

Step 2: How to install the Braintree App in Linnworks:

To use Braintree, you must first install it from within

  • Log into
  • Select Settings in the left-hand menu bar
  • Select Application Store
  • Click Braintree Payment for Linnworks
  • Click Install

User Guide Braintree

Step 3: How to open the Braintree App:

  • Log into
  • In the left-hand menu, click Braintree.
  • The first time you open the app, the Registration page will load.
  • Tick the box to show you have read the Terms and Conditions.
  • Click Register Now to proceed.
  • You will need to configure a Braintree account. (Step 5)

Step 4: Linnworks Direct Orders:

When the app opens, you should see a list of Direct Orders with the payment status Not Paid in Linnworks Open Orders.

  • View Order :
  • Displays the order contents.
  • Pay :
  • The pay button allows you to take payment for a Linnworks Direct order in the list.
  • This takes you to a confirmation page. Click Pay Now to continue.

User Guide Braintree

User Guide Braintree

This proceeds to the payment screen, where you can enter the payment card details.

User Guide Braintree

Once the card details have been entered correctly, the Pay Now button (at the bottom) becomes active, and the amount to be paid will be displayed.

On clicking Pay Now, payment is transferred to your Braintree account and the app returns to the Braintree Direct Orders screen.

To take another payment, follow same process.

  • Sending Braintree Invoices:

User Guide Braintree

  • To request payment via email to the Customer, from the list of orders, click Send Braintree Invoice.


Step 5: Braintree Configuration:

User Guide Braintree

User Guide Braintree

  • Select Production or Sandbox.
  • If you have an existing Braintree account, enter your registered Email address and Password, before clicking Log In.
  • If you don’t have a Braintree account, click the Sign Up link to create an account.

  • After successfully logging in, you will be redirected to the Braintree Dashboard.
  • In the Up panel, select Settings in Users and Roles.

  • You will need to add your Braintree account details. Click Edit.

  • Click View Authorizations.

Click to show Public Key and Private Key.

User Guide Braintree

The next screen will show your account’s Public key, Private key and Merchant ID for Test and Live services.

Take note of your Live keys for use in the Braintree app.

User Guide Braintree

  • Enter them as shown below, then click on Save.

Step 6: Email Setting:

  • In Email Settings you are offered two options:

User Guide Braintree

  • To configure the email server configuration:

User Guide Braintree

Enter the SMTP server address, the Port Number, confirm if SSL Security and SMTP Authentication is required.

  • Enter the User Name & Password for the account and the From Name which will be used when email is sent from the account.
  • The Reply To address specifies the address that will receive customer’s replies, if you wish it to be different to the address used to send.
  • Test your configuration and click Save.


  • Email Template Configuration:
  • We can set up different options for the Message Body
  • Logo: allows you to upload a Logo to be displayed in emails sent.
  • Subject Tag: Specifies an order field that can be used in the email subject. Click Add to insert it into the Email Subject field.

User Guide Braintree


I. Email Subject: Mixes text and information from the order itself using Subject Tag to display a custom subject for each email.
II. Body Tag: Specifies an order field that can be used in the email body. Click Add to insert it into the Email Body.
III. Email Body: Starts with a predefined message. This can be customized with your own text, as well as with information from the order using Body Tags.

  • Remember to click Save to ensure the configuration is retained

User Guide Braintree

Step 7: Braintree Payment History:

User Guide Braintree

  • This page displays a list of payments on your Braintree account.
  • To narrow down the period covered, or to change it, adjust the Dates at the top of the screen to specify the Start and End dates.
  • Click View Report.

User Guide Braintree

Step 8: Purchase Credit:

User Guide Braintree

Payment confirmation SMS messages can be sent using credits. There are several subscription levels you can choose, each corresponding to a different monthly credit balance.

User Guide Braintree

If you run out of credits, or are just starting, you can click to select the subscription you need.

If you’re partway through the month and upgrade, your account will be credited with the difference between the the credits you have used this month and the new monthly allowance.

  • Click on the Submit button.

Step 9: Invoice:

Let's get in touch

Give us a call or fill in the form below and we will contact you. We endeavor to answer all inquiries within 24 hours.