PayPal (legacy)

There are two ways in which PayPal can be used with Brightpearl:

  • As a payment processor on the web portal
    This allows your customers to make a payment to you via the web portal using PayPal. This will automatically create accounting and mark invoices as paid.
  • As a bank feed
    This will download a list of all transactions which pass through your PayPal account onto the PayPal Log in Brightpearl. You can review the list in Brightpearl and then choose for which transactions you need to create the accounting. Note that many sales channels will already be creating payments including PayPal, so you won't necessarily need to create all of the listed transactions.

Setting up the PayPal app

How to set up PayPal

  1. You will need a PayPal Business Account.
  2. Request API details from PayPal using the instructions here: Obtaining API Credentials
    Note : While obtaining your API Credentials you are offered the choice between a certificate or a signature - please choose the signature option.
  3. Open your Brightpearl account, and turn on the PayPal app within the App Store.
  4. Click the Set Up button on the PayPal app to access the settings.
  5. Enter your PayPal credentials and save your changes.
  6. Now go to Settings > Company > Payment methods .
  7. Add a new payment method.
  8. Give the payment method the code of PAYPAL .
  9. Link the PayPal app to the payment method by selecting it from the dropdown.
  10. Select the bank account where accounting should be created for PayPal webportal transactions.
  11. Save the payment method.

PayPal on the webportal

PayPal can be directly integrated with Brightpearl to allow customers and suppliers to make payments through the Brightpearl web portal - available with all Brightpearl accounts. This will mark the invoice as paid in Brightpearl, update the customer/supplier account balance and create sales receipt accounting journal.

PayPal offer an auto-return feature which allows you to dictate where they are redirected to once they have completed the payment.

PayPal as a bank feed

Your PayPal account can be integrated directly with Brightpearl so that you can download and view your PayPal transactions on the PayPal Log.

This integration allows you to generate accounting entries directly from the downloaded transactions and to allocate payments to sales orders. However, if you are using integrated sales channels, PayPal payments made via those channels will be handled by the sales channel integration and should not be processed in this way.

To find out more about handling payments from sales channels please refer to the relevant sales channel section of the support documentation.

It is not possible to create new PayPal transactions from within Brightpearl using this integration, only to create the accounting in Brightpearl. However,  Brightpearl also offers PayPal as a payment method for use on the web portal.

Downloading PayPal Transactions

Transactions will only download when the sync is manually activated from the PayPal Log.

When the integration is first actived the last 3 months of transactions will be downloaded. From then on each sync will check for new transactions within the last 30 days. No transaction will download more than once.

Using the PayPal Log

The PayPal Log is where all the transactions can be viewed and selected for processing, which will create the accounting.

Access the PayPal Log via  Accounting > List bank accounts .

transactions relating to downloaded sales

It is important that transactions relating to downloaded sales orders via integrated sales channels are not processed since this will duplicate the payment and accounting created by the sales channel integration.

For any other transaction not already created in Brightpearl, the PayPal Log can be a useful way of generating the accounting entries. Select the items and click the Create accounting button.

How to create accounting from the PayPal Log

Note : This process should not be used for transactions relating to payments received via integrated sales channels. This will duplicate payments.

  1. Go to your PayPal log via Accounts > List bank accounts .
  2. Select the transaction(s) that need to be posted to accounts.
  3. Click the Create accounting transactions button.

create account transactions

How to allocate a PayPal payment to an order/invoice

  1. Go to Accounting > List bank accounts > View PayPal log .
  2. Find the PayPal transaction on the PayPal Log; use the filters to search by customer email or amount.
  3. Highlight and copy the PayPal TXN ID .
  4. Search for and open the sales order/invoice.
  5. Click the Allocate PayPal transaction  button at the bottom of the screen.
  6. Paste in the TXN ID and click Allocate .

PayPal allocate

This will simultaneously mark the order as paid, reduce the customer account balance and create the necessary accounting (SR journal). Any related fees will not automatically be created; these accounting transactions can be created from the PayPal Log.

How to correct mismatched PayPal transactions (detaching)

  1. Go to your PayPal log, via Accounting > List bank accounts .
  2. Search for and select the checkbox next the transaction that has been created / matched to an order by mistake.
  3. Click the Detach from accounts button. This unlinks the accounting from the transaction.
  4. Copy the PayPal transaction ID and paste it into the QuickSearch box, select Accounting in the drop-down and then click Go to find the original accounting journal entered.
  5. Click the journal ID to view/edit. You need to cancel this journal.
  6. Enter a reason for modification then click the Cancel button.

The PayPal transaction can now be processed again, as required.

PayPal fees

PayPal fees are not accounted for on PayPal payments downloaded from sales channels (such as Magento or eBay), since the payment information is downloaded directly from the channel and not PayPal. You will therefore need to ensure that the PayPal fees are accounted for for those transactions. This can be done in one of several ways, depending on how you want the accounting to look and how many transactions you are dealing with and therefore what's easier for you:

  • Add up all the fees from your PayPal statement and manually enter a single journal to debit your PayPal fees nominal code and credit your PayPal bank account

Paypal fee adjustment

  • Use the PayPal log to automatically create just the fees . This will create a journal per transaction to debit your PayPal fees nominal code and credit your PayPal bank account. Since the original payment has already been accounted for this part doesn't need to be done

PayPal fees create

How to enter a journal

  1. Go to  Accounting > Enter Journal .
  2. The date defaults to today's date, to post to a prior date you can change it. The date must be an open accounting period.
  3. Use the Details section to write a reason for the journal; really useful if you need to investigate the changes down the line.
  4. If you're posting entries to nominal codes Accounts Receivable (1100) or Accounts Payable (2100) always enter a Contact ID to connect the entry it to a customer or supplier account.
  5. On the first row select the nominal account for the entry and then enter the amount in either the Debit or Credit column.
  6. If tax is applicable on the value select the Tax Code. By entering a tax code the value will appear as a balance on your Sales/Purchase Tax report.
  7. Continue to enter journal lines, click the  Add Row  button to add more lines.
  8. When the total debits = total credits click  Save Journal  to post it to accounts.

The journal will immediately update the relevant accounts.

How to create PayPal fees

PayPal fees can be entered as a single figure by using a manual journal. Alternatively, the PayPal log can be used to create a journal per transaction:

  1. You will need to have activated the PayPal log at Settings > Brightpearl Apps > PayPal .
  2. Go to the PayPal log via Accounting > List bank accounts and clicking the View PayPal Log link against the PayPal bank account.
  3. Select all the transactions for which the fees need to be created.
  4. Click the Create accounting transactions button.
  5. In the pop-up window check the box to transfer fee amount from PayPal account to: Note that you should not select the check box to create a bank receipt where handling payments related to sales channels since this part of the transaction will already have been created from the channel.

paypal fees create

  1. Select the nominal code where PayPal fees should be recorded.
  2. Click the Create transactions button.

A journal for each transaction will be created to debit the selected nominal code and credit the PayPal bank account.

PayPal fees journal

Have more questions? Submit a request