Payments

When a buyer pays through Stripe or PayPal, the provider keeps a fee. If you connect the provider, BrickInvoice can look up those fees and book them in your accounting package. You connect them under Connections → Payments (/home/connections/payments).

Table of Contents

• When you see the Payments page
• Stripe
• PayPal
• Booking the fees

When you see the Payments page

The Payments item shows in the menu when your accounting package books the fees of Stripe, PayPal or both. If your package books neither, the item is hidden. The page itself still opens at its address.

The page has a block for Stripe and one for PayPal, each with a status badge (Connected or Not connected). The links at the top jump to a block (#stripe or #paypal) and show its status with a coloured dot.

If your accounting package does not book a provider's fees, its block says so: the fees stay out of your accounting, and you can still connect the provider. Without an accounting package, the block says the fees are not booked yet. You can connect the provider in both cases.

Stripe

One or two Stripe accounts

The first time, the Stripe block asks How many Stripe accounts do you use?

• One shared account: BrickLink and Brick Owl payments both come in on the same Stripe account.
• Separate accounts: BrickLink and Brick Owl each have their own Stripe account. You then connect a key for each store.

BrickInvoice uses this to look up the right fee for each order. To change it later, click Switch to separate accounts (or Switch to one shared account). BrickInvoice asks first, because switching disconnects your current Stripe connections. You then connect again.

Make a restricted key

Use a restricted key, not your full secret key. A restricted key can only read what BrickInvoice needs. The help card next to the form has these steps:

1. In your Stripe Dashboard, go to Developers → API keys and click Create restricted key.
2. Choose Provide this key to another website.
3. Enter a name, such as BrickInvoice, and the URL https://www.brickinvoice.com. Tick Customize permissions for key.
4. Under Authorizations, set all permissions to No except Balance Transfers and Charges and Refunds, which you set to Reading.
5. Confirm the key through the e-mail Stripe sends you.
6. Copy the key. It starts with rk_live_.

Connect it

1. Paste the key into Restricted API Key (for the shared account, or for BrickLink or Brick Owl).
2. Click Test Connection. When the key works, you see Stripe connection successful.
3. Click Save Connection. This button only works after a successful test.

The block then says Stripe (…) is successfully connected. Go to your accounting settings to enable fee syncing and choose the expense account. Go to Settings takes you there. Disconnect removes the key after you confirm.

PayPal

Get your API credentials

1. Go to the PayPal Developer Dashboard (the help card links to it) and log in with your PayPal business account.
2. Create a new Live app and copy its Client ID and Client Secret.
3. In the app settings, under Add-on services, turn on Transaction search. Without it, BrickInvoice cannot read your PayPal fees.

Connect it

1. Paste the values into Client ID and Client Secret.
2. Click Test Connection. When they work, you see PayPal connection successful.
3. Click Save Connection. This button only works after a successful test.

The block then says PayPal is successfully connected. You can now enable PayPal fee tracking in your accounting settings. Go to Settings takes you there. Disconnect PayPal removes the credentials after you confirm.

Booking the fees

Connecting a provider does not book anything yet. Go to Accounting → Configuration, turn on the fee sync for the provider and choose the expense account the fees go to. Which accounting packages book which fees is in the feature comparison, and how the fees are booked is in the accounting overview.