Skip to content
Help support@rechnungskit.de
Topics: Setting up integrations

Connect PayPal

Connect PayPal through your own live REST app with Transaction Search switched on. What you need, the setup step by step, common errors, and how Rechnungskit fetches payments and books fees and withdrawals for DATEV.

Updated

You connect PayPal through your own REST app in your PayPal account. It takes a few minutes once; after that everything runs automatically. What Rechnungskit does with PayPal payments, from the e-invoice to the fee booking, is on the product page.

PayPal · fetch and webhook
From the PayPal payment to the DATEV export
PayPal
Your business account
Payments from your shopShopify, WooCommerce and others, through their own PayPal connection
Payments in the Rechnungskit checkoutrun through your REST app
Plusfees, refunds, disputes, withdrawals
Rechnungskit
  1. Fetch every few hoursTransaction Search, last 7 days: payments, refunds, fees
  2. Webhook right awayonly for payments through the Rechnungskit checkout, signed
  3. Matchingorder number from custom_id or invoice_id; for Shopify, the PayPal transaction ID if needed
  4. Withdrawalsdaily, from the transaction history of the last 30 days
Result
E-invoicefor the matched order; for a refund, the cancellation invoice
Open casesdisputes and payments without an order, under Payments
DATEV payments batchits own PayPal clearing account, fee per transaction
Rechnungskit never starts payments or refunds through the app. Shop payments arrive only through the fetch, because PayPal sends webhooks only for payments of the same app.

Before you start

You need your PayPal business account, specifically the account your shop payments go into. You sign in to the PayPal Developer Dashboard (developer.paypal.com) with the same credentials; you don't need a separate developer account. Setup takes about five minutes. After that, PayPal can take up to 9 hours to release the transaction data for the new app, so you often see the first payments the next morning.

Checklist
What you need before you connect
PayPal business accountThe account your shop payments go into. An app in a different PayPal account can't see these payments
required
Sign-in to the PayPal Developer Dashboarddeveloper.paypal.com, with your business account credentials
same sign-in
About five minutescreate the app, tick one box, copy two values
once
Patience until the first fetchPayPal releases Transaction Search with a delay of up to 9 hours
up to 9 hrs

Setup

Setup · about five minutes
Create your own live app and enter it in Rechnungskit
PayPal Developer Dashboard
  1. Switch to Live at the topnot Sandbox, also for Rechnungskit's test mode
  2. Apps & Credentials → Create Appname it Rechnungskit, for example
  3. Tick Transaction searchunder Add-on services, off by default. Customer disputes stays on
  4. Copy the client ID and secretPayPal only shows the secret after a click
Rechnungskit
  1. Settings → Connections → Shops and payment providersclick "Connect" on the PayPal card
  2. Paste both valuesPayPal client ID and Secret Key, then connect
Rechnungskit checks
Credentialsagainst Live first, then Sandbox. The card then shows "Live mode" or "Test mode"
Webhookis created on your app. If that fails, nothing is saved
Transaction searchone short test fetch. If the permission is missing, the card shows the steps right away
Rechnungskit stores the credentials encrypted. You don't need to fill in the Live Webhooks section in the PayPal dashboard.
  1. In the PayPal Developer Dashboard (opens the Live tab), create your own REST app under Apps & Credentials (Create App, name it Rechnungskit, for example). Important: select Live at the top, not Sandbox. Rechnungskit needs live credentials, in Rechnungskit's test mode too.

    PayPal Developer Dashboard, Apps & Credentials: the switch at the top left is set to Live (marked), the Create App button on the right (marked)

    PayPal Create App dialog: app name "Rechnungskit" entered, the Create App button below

  2. In the app, under Add-on services, TURN ON the Transaction search checkbox (it is off by default). Important: PayPal releases the data with a delay of up to 9 hours. Right after you turn it on, the fetch returns nothing yet, and "Sync now" under Payments reports "0 payments checked" even though the connection is correct. That is normal: Rechnungskit fetches automatically every few hours and catches up on the last 7 days as soon as PayPal provides the data, usually the next morning. If it still shows 0 after a day, check that the REST app really belongs to the PayPal account that receives your shop payments. Customer disputes is on by default and stays on. All other checkboxes (Checkout, SDKs, Vault, Subscriptions, Invoicing, Payouts) don't matter for Rechnungskit.

    PayPal Developer Dashboard, app page, Add-on services section: Customer disputes and Transaction search are ticked and highlighted, Log in with PayPal stays off

  3. Enter the client ID and client secret at PayPal under Settings → Connections → Shops and payment providers (the "Connect" button on the PayPal card). Rechnungskit detects automatically whether these are live or sandbox credentials: it tries them against Live first, then against Sandbox. The card then shows "Live mode" or "Test mode". If it says "Test mode", you picked up a sandbox app, where your real payments never show up. For checkout and subscriptions in test mode, you add the sandbox app separately in the "Test credentials" field below the card, see Checkout and subscriptions in test mode.

    PayPal app Rechnungskit, API credentials section: Client ID and Secret key 1 (hidden, with the eye icon to show it and the copy icon) are marked

    Rechnungskit, Settings → Connections → Shops and payment providers: the connected PayPal row (MERCHANT-NORDLICHT · Live mode · Webhook active) with its settings open. The key form is open, with the fields PayPal client ID and Secret Key, the note that both values come from your own REST app in the PayPal developer dashboard and that the webhook is registered automatically, the link to the PayPal developer dashboard (live) and the buttons to save and cancel. For a new connection you open the same form through "+ Add connection"

  4. Rechnungskit registers the webhook in your app automatically, including signature verification of the messages. The Live Webhooks section in the PayPal dashboard can stay empty. If the webhook can't be created, Rechnungskit doesn't save the connection. After that, Rechnungskit fetches the transactions of the last hour once. If PayPal refuses, the connection stays saved, the PayPal card shows the steps right away and an urgent task opens, see "Transaction search" is missing.

Good to know: PayPal only sends webhooks for payments that run through exactly this app. Payments from Shopify or WooCommerce run through their own PayPal connection, so no webhooks arrive for them. That is not an error. Rechnungskit fetches these payments and refunds through Transaction Search. The webhook covers payments through the Rechnungskit checkout.

When something goes wrong: no payments come in

Common snags
What you see and what's behind it
"PayPal credentials invalid (check client ID/secret)"
PayPal rejects the values, both live and in the sandbox. Usually a character got cut off, or the client ID and secret are swapped
Fixcopy both values again from the live app
The card shows "Test mode"
The credentials come from a sandbox app. The connection works, but your real payments never show up there
Fixcreate a live app, then "Rotate key"
"PayPal refuses the transaction list: “Transaction Search” is missing"
PayPal answers every fetch with 403 NOT_AUTHORIZED. No withdrawals and no refunds arrive, and missed payments are not caught up
Fixtick Transaction search on the app, then "Fixed, check now"
"0 payments checked" right after connecting
Transaction search is off or not released yet. PayPal takes up to 9 hours for that
Fixcheck the box, wait until the next morning
Still nothing after a day
The app belongs to a different PayPal account than the one your shop payments go into. If your shop reports PayPal orders, a task appears for it
Fixcreate the app in the right business account
"Connection failed: PayPal API not reachable"
PayPal couldn't be reached or refused to create the webhook, for example because the app already has ten webhooks
Fixtry again later, delete old webhooks of the app
Note "PayPal already runs through …"
PayPal already comes in through Mollie, Stripe or Unzer. The direct connection captures the same payments a second time
Fixdisconnect the direct connection if everything runs through the other provider
No webhooks for Shopify or WooCommerce payments is not an error: the fetch picks up these payments.
  • Message "PayPal credentials invalid (check client ID/secret)", usually with HTTP 401: PayPal accepted the values neither live nor in the sandbox. Copy the client ID and secret again from the live app; often a character is missing or the two values are swapped.
  • Red notice "PayPal refuses the transaction list: “Transaction Search” is missing" on the PayPal card (plus an urgent task and one email): Transaction search is not ticked on your app. See "Transaction search" is missing for the fix.
  • The PayPal card shows "Test mode" instead of "Live mode": the credentials belong to a sandbox app. Create the app in the live area and enter the new values through "Rotate key".
  • "Sync now" reports "0 payments checked": Transaction search is off, or PayPal hasn't released it yet (up to 9 hours). Check the box and wait until the next morning.
  • Still no payments after a day: the app probably belongs to a different PayPal account. If your shop reports orders with PayPal while the PayPal connection hasn't delivered a single payment yet, Rechnungskit creates a task for it.
  • Message "Connection failed: PayPal API not reachable": PayPal couldn't be reached or refused to create the webhook, for example because the app already has ten webhooks (PayPal allows no more per app). Try again later and delete webhooks of the app you no longer use in the PayPal dashboard.
  • Note "PayPal already runs through Mollie" (or Stripe, Unzer): the direct connection captures the same payments twice. Rechnungskit detects duplicates of Mollie and Stripe payments automatically and classifies them as non-revenue; for Unzer that is technically impossible. If all PayPal payments run through the other provider, disconnect the direct PayPal connection.

Without the Transaction search box ticked on your REST app, PayPal refuses every transaction fetch with "403 NOT_AUTHORIZED" ("Authorization failed due to insufficient permissions"). While that lasts, no withdrawals to your bank account and no refunds (and so no cancellations) reach Rechnungskit, and payments whose webhook got lost are not caught up. Payments through Rechnungskit Checkout still arrive by webhook.

Rechnungskit tells you right away instead of after the next nightly run:

  • when you connect, through a short test fetch, and on every later fetch (payments, refunds, withdrawals),
  • as a red notice on the PayPal card under Settings → Connections → Shops and payment providers, with the steps and a "Fixed, check now" button,
  • as the urgent task "PayPal: “Transaction Search” is missing", at the top of its group under Overview → Tasks,
  • once by email to owners and admins. After that the open task appears in your task reminder; there is no second email.

How to fix it:

  1. Log in at developer.paypal.com and open "Apps & Credentials".
  2. Switch to "Live" at the top and open the app that is connected to Rechnungskit.
  3. In the "Add-on services" section ("Features" in some views), tick "Transaction search" and save.
  4. Wait until PayPal activates it. That can take up to 9 hours.
  5. In Rechnungskit, click "Fixed, check now" on the PayPal card, or "Sync now" on the Payments page.

"Fixed, check now" runs a short test fetch. If PayPal releases the transactions, the task closes and Rechnungskit fetches payments, refunds and withdrawals at once. If PayPal still refuses, the task stays open. If you don't check yourself, the next successful fetch closes the task, within four hours at the latest. Every check is recorded in the task with time and result.

If the box is ticked and PayPal still refuses after a day, the app probably belongs to a different PayPal account than the one that receives your shop payments. Create the app in the right business account and enter the new credentials through "Rotate key".

What happens automatically

  • Rechnungskit fetches payments and refunds every few hours through Transaction Search (last 7 days); payments through the Rechnungskit checkout also arrive instantly by signed webhook. A refund creates the cancellation invoice (Storno) automatically as soon as the original payment is matched to an order.
  • If your shop reports a refund via PayPal, Rechnungskit waits for the matching refund at PayPal and creates the cancellation invoice from it. If the shop refund is further back, the fetch automatically catches up on up to 31 days. If no refund arrives at PayPal after a day, Rechnungskit creates the task "Shop change after the invoice" (see aufgabe-shop-correction). It closes on its own once the cancellation invoice exists.
  • The PayPal fee is recorded per transaction and shown as a booking of its own, not netted against revenue. In the DATEV export PayPal has its own clearing account (Geldtransit; preset 1362 in SKR03, 1462 in SKR04): payments, fees and refunds book to it, payments and refunds against the invoice's customer account (Debitor; revenue and VAT come only from the revenue batch), and withdrawals to the bank account as a transfer from the clearing account to the bank. The fee books per payment on the payment date (fees against the clearing account). When PayPal returns part of the fee on a refund, that part books the other way round. You can change the account in the DATEV settings on the "Payment accounts" tab.
  • Chargebacks (disputes) reopen the item and land in the tasks for clarification, including the dispute fee. Disputes you win are resolved accordingly; no automatic cancellation invoice is created.
  • The order number is read from the PayPal fields (custom_id, invoice_id) and used for matching.
  • With Shopify, invoice_id does not always hold the order number; sometimes it holds an internal key of the checkout session. For these payments Rechnungskit reads the PayPal transaction ID from the Shopify order and matches on that unambiguously. This needs no setting, only the connected Shopify connection (see zahlungen-abgleich).

How the DATEV export books a PayPal payment

By default the payments batch books a PayPal payment as PayPal clearing to customer account (Debitor). The fee goes to bank charges (Nebenkosten des Geldverkehrs) against clearing (SKR03 4970, SKR04 6855), the withdrawal to bank against clearing (SKR03 1200, SKR04 1800). A refund is the payment in reverse, customer account to clearing; the cancellation invoice in the revenue batch reduces revenue and VAT. After payment, fee and withdrawal, the customer account and the PayPal clearing account are both at zero, and your tax advisor can reconcile the clearing account directly against the PayPal statement.

These bookings get documents too: for a month's fees Rechnungskit creates a monthly fee list as a PDF, and a payout statement for every withdrawal. With Belegtransfer on, every fee and withdrawal booking links to it (Payout statements in the payments batch).

Example · SKR04 · debit an credit · amounts made up
A PayPal payment in the DATEV export
Sale with withdrawalAccount an contra account
Invoice1200 an 4400 €119.00 · revenue batch
Payment1462 an 1200 €119.00 · clearing to customer
Fee6855 an 1462 €3.95 · per transaction
Withdrawal1800 an 1462 €115.05 · bank to clearing
Afterwardscustomer €0.00, PayPal clearing €0.00
RefundAccount an contra account
Invoice1200 an 4400 €119.00 · revenue batch
Payment1462 an 1200 €119.00
Storno4400 an 1200 €119.00 · cancellation invoice, revenue batch
Refund1200 an 1462 €119.00 · customer to clearing
Afterwardscustomer €0.00, no revenue
In SKR03 the accounts are 1400 (customer), 8400 (revenue 19 %), 1362 (PayPal clearing), 4970 (fees) and 1200 (bank). "1462 an 1200" is the German booking notation: debit account an (to) credit account. All accounts are defaults; your tax advisor changes them in the DATEV settings. The refund on the right is shown without a fee.

Withdrawals to your bank account

PayPal has no payout API like Stripe or Mollie. Instead, Rechnungskit reads the transaction history every day (Transaction Search, last 30 days) and recognizes withdrawals to your bank account as transfers.

PayPal always pays out your balance. So under Payments → Payouts, Rechnungskit splits each withdrawal into everything that moved the balance since the previous withdrawal: sales with their fee, refunds (including any fee PayPal returned), PayPal's own fee transactions, and other movements such as disputes, holds or currency conversions. Whatever was on the balance before, or is left on it afterwards, shows as a separate line "Balance carried over (PayPal)". Sales and refunds are linked to their payments by the PayPal transaction ID, which is why the Lines column shows something like "870/876". A sale from before your Belegstart is marked "before Belegstart" and does not count as unmatched. The same goes for a refund whose sale was before your Belegstart: Rechnungskit asks PayPal for the sale date and marks the refund "before Belegstart" automatically. If a sale from after your Belegstart is missing, Rechnungskit fetches it along with its refund, and it gets its invoice and cancellation like any other. Any other line with no payment in Rechnungskit stays visible as unmatched.

Rechnungskit, Payments → Payouts, detail page of a PayPal withdrawal of €274.77 from 15/10/2026 in the demo account: at the top gross €284.54 minus fees €9.77 equals payout €274.77, "Reconciled" and "Sums reconcile". Below, the lines: a refund of −€35.00 marked "Unresolved" with the "Assign" button, "Holds and releases (PayPal)" of −€25.00, "Balance carried over (PayPal)" of €12.34, a fee of €0.40 returned by PayPal, four payments with their fees matched "Automatic", and a refund of −€19.90 marked "before Belegstart"

Withdrawals PayPal still lists as pending also count as withdrawals, because the money left the balance at that moment. PayPal holds, for a dispute or an open authorization for example, lower the balance that can be paid out, and PayPal reports the status of their releases inconsistently. So if a gap remains between the lines and the withdrawal that is no larger than the holds and releases of the period, it shows as its own line "Holds and releases (PayPal)" listing those PayPal transactions, and the withdrawal counts as reconciled. Sometimes PayPal puts money on the balance without listing a row for it. The balance PayPal sends with every transaction shows this: it jumps by more than the row's amount. If such jumps explain the gap to the cent, each one shows as a line "Balance movement without its own line (PayPal)" with its date and amount. A larger gap stays visible as a difference with a task. The next "Sync now" under Payments also rebuilds older withdrawals that still show a difference, up to six months back.

Rechnungskit, lines of a PayPal withdrawal in the demo account: at the top "Balance movement without its own line (PayPal)" of €39.24, below it "Balance carried over (PayPal)" of −€15.30 and three payments with their fees, each matched "Automatic"

The fees in a withdrawal's header only show what it is made of. They are still booked per payment on the payment date (see above), never a second time from the withdrawal.

"Not itemized" with "total only" appears on a withdrawal whose predecessor Rechnungskit doesn't know: the first one after you connected, one whose previous withdrawal is more than six months back, or one that was already older than 30 days when Rechnungskit started itemizing on 20 October 2026. For the oldest withdrawal in the 30-day window, Rechnungskit fetches the missing period once. "Not itemized" needs nothing from you and no change to any permission: the payments themselves, with their fees, are under Payments.

Limits

Quick check
What the PayPal connection covers
Payments and refunds from shop and checkoutthrough the fetch; checkout payments also by webhook
Automatic
Fees and withdrawalsfee per transaction, withdrawals detected daily, as long as Transaction search is on
Automatic
Repayments of a PayPal business loana monthly task for clarification by default, booked only with the switch turned on in the DATEV settings
only with the switch
Webhooks for Shopify and WooCommerce paymentsPayPal sends them only for payments of the same app. The fetch makes up for it
Not available
  • Rechnungskit doesn't book repayments of a PayPal business loan (transaction codes T9701/T9702) on its own, because PayPal does not document their booking codes reliably. By default they appear as a monthly task for clarification. If you turn on "Book PayPal business loan repayments" in the DATEV settings, the export books them through the mapping paypal_credit_repayment (loan liability to PayPal clearing). Agree on this with your tax advisor first.
  • If PayPal runs through Mollie for you, you don't need the direct PayPal connection; the Mollie integration covers it.
  • Without Transaction Search turned on in the REST app, fees and withdrawals stay incomplete.

Frequently asked questions

PayPal already runs in my Shopify store. Why do I still need my own app?

Shopify handles PayPal through its own PayPal connection, and so does WooCommerce. Rechnungskit has no access to that data. Through your own REST app, Rechnungskit reads the transactions of your business account, including the payments from your shop. You don't change anything about the PayPal setup in your shop.

What can Rechnungskit do with the app?

Rechnungskit reads transactions, fees, refunds and disputes, and creates its webhook on the app when you connect. It doesn't start payments or refunds. If you use PayPal in the Rechnungskit checkout, Rechnungskit handles your buyer's payment there through the same app.

Do I have to enter anything under Live Webhooks?

No. Rechnungskit creates the webhook itself when you connect. If a Rechnungskit address then shows up in the app's webhook list, that is this webhook. Don't delete it.

Can I try it with the sandbox first?

You can connect a sandbox app too; the card then shows "Test mode". But your real payments never appear there. So use the live app right away, even if your Rechnungskit project is still in test mode. For your shop, Rechnungskit only reads anyway.

I connected, but nothing arrives. What now?

Wait first: PayPal releases Transaction search with a delay of up to 9 hours. After that, Rechnungskit catches up on the last 7 days with the next fetch, or right away through "Sync now" under Payments. If it's still empty after a day, check the box and whether the app sits in the right PayPal account (see When something goes wrong).

Several WooCommerce shops with one PayPal connection

If two WooCommerce shops in the same project use the same PayPal account, one PayPal connection is enough. Give each shop its own "Invoice prefix" in WooCommerce PayPal Payments, for example "SHOPA-" and "SHOPB-". PayPal then receives "SHOPB-1234" instead of "1234", and Rechnungskit matches the payment only to orders from shop B. Rechnungskit reads the prefix from the shop, or you enter it on the WooCommerce card under "PayPal invoice prefix". If there is no prefix and the same order number exists in both shops, you get a task to assign the payment (see woocommerce).

Where to find it in the app

Recent changes

Still have a question? Ask Kit in the app or write to support@rechnungskit.de
No tax or legal advice

Rechnungskit is not a tax advisory or law firm. This article explains general principles and does not replace advice from a tax advisor (Steuerberater, § 5 StBerG) or a lawyer (§ 3 RDG). Rechnungskit is built for businesses based in Germany and prepares documents, tax rates and bookings automatically. How your specific case is treated remains your decision, ideally together with your tax advisor or a lawyer.

de en