Topics: Resolving tasks
- Help & docs
- Resolving tasks
- Add a missing permission to your Stripe key or PayPal app
Add a missing permission to your Stripe key or PayPal app
Your Stripe key lacks a permission, or your PayPal app lacks "Transaction search". How to add it and have it checked right away.
Updated
This task sits at the very top of the "Holds documents back" group on the Overview and under Overview → Tasks. For PayPal it is called "PayPal: 'Transaction Search' is missing". The task reminder email lists it as "Urgent: a connection is missing a permission (Stripe key or PayPal "Transaction Search")", with the cause and the fix.
- TriggerStripe rejects a callthe key lacks a permission and the invoice is held back
- YouAdd the permission to the Stripe keythen click "Fixed, check now" in Rechnungskit
- ThenInvoices are createdthe held invoices are issued and the task closes
What happened
A call to Stripe or PayPal failed because a permission is missing. The task names the permission as the provider calls it, for example "Stripe key: “Funding Instructions” (write) permission missing" or "PayPal app: “Transaction Search” permission missing". There are three cases:
| What the permission is for | Missing permission | Where you fix it |
|---|---|---|
| Stripe invoices with a payment term | "Funding Instructions" (write), for the bank details on the invoice | The "Stripe invoices with a payment term" card under Settings → Documents → Document rules, with "Fixed, check now" |
| Orders via the API with paymentGateway "stripe_transfer" | "Customers" (write) or "Payment Intents" (write) | Settings → Connections → Shops and payment providers, no check button |
| PayPal: withdrawals, refunds and catching up missed payments | "Transaction search" on your PayPal REST app | The PayPal card under Settings → Connections → Shops and payment providers, with "Fixed, check now" |
The first time it happens you immediately get an email with instructions. For Stripe it is sent again if the task reopens after a fix. For PayPal it is sent only once per connection; after that the open task appears in your task reminder.
Why Rechnungskit stops here
For Stripe: without this permission Rechnungskit cannot put your customer's Stripe bank details on the invoice. Rechnungskit never puts your own bank's IBAN there instead. Otherwise the money would bypass Stripe and the payment at Stripe would stay open. So Rechnungskit does not create the invoice and sends nothing until the permission is there.
For PayPal: without Transaction search, PayPal refuses every transaction fetch with "403 NOT_AUTHORIZED". Rechnungskit then gets no withdrawals to your bank account and no refunds (and so no cancellations), and can't catch up missed payments. Invoices are not held for this. Payments through Rechnungskit Checkout still arrive by webhook.
How to resolve it
- In the Stripe Dashboard, open the restricted key Rechnungskit uses under Developers → API keys.
- Set the permission named in the task to write, for example "Funding Instructions".
- In Rechnungskit, click "Fix now" on the red notice. For Stripe invoices with a payment term, the link takes you to the "Stripe invoices with a payment term" card under Settings → Documents → Document rules. It also shows how many invoices are waiting.
- Click "Fixed, check now" there. Rechnungskit checks the permission right away, creates the held invoices and shows you which ones were created.
In the "stripe_transfer" case the link takes you to Settings → Connections → Shops and payment providers. There is no check button there. The task closes as soon as the next invoice with Stripe bank transfer succeeds.
For PayPal:
- In the PayPal developer dashboard, open your live apps and the app that is connected to Rechnungskit.
- In the "Add-on services" section ("Features" in some views), tick "Transaction search" and click "Save Changes" at the bottom. Without saving, PayPal doesn't keep the tick.
- Wait until PayPal activates it. That can take up to 9 hours.
- On the PayPal card under Settings → Connections → Shops and payment providers, confirm that you ticked and saved it, then click "Fixed, check now", or "Sync now" on the Payments page.
The PayPal card shows you where the tick sits in the app. If PayPal still refuses when you click "Fixed, check now", Rechnungskit checks again on its own after 9 hours. If it works then, the task closes. If the permission is still missing, you get an email with the steps.
More under Connect PayPal.
When the task closes on its own
As soon as a call with the permission succeeds, the task closes. For PayPal that is the next successful fetch: your click on "Fixed, check now", "Sync now", connecting again, or the automatic fetch every four hours. Rechnungskit then fetches the missing payments, refunds and withdrawals. For Stripe invoices with a payment term this happens through your click on "Fixed, check now", when you save a new Stripe key under Settings → Connections → Shops and payment providers (Rechnungskit then checks the permission right away), or through the automatic check every four hours. The automatic check only runs while invoices are being held.
If the permission goes missing again later, the same task reopens. Every check is recorded with time and result.
Related settings
- Settings → Documents → Document rules → Stripe invoices: switch and permission check
- Settings → Connections → Shops and payment providers: replace the Stripe key, check the PayPal permission
Where to find it in the app
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.