Overview
PayPal refunds executed by Lumtry
Connect PayPal to Lumtry with your own REST app credentials and approved refunds are paid from the original capture in your PayPal account. Lumtry checks the credentials before saving them, sends a request id with every refund so a retry cannot pay twice, and verifies PayPal's signature on each event it receives.
Overview
What it does
- Pays approved refunds, full or partial, from the original capture through your own PayPal account.
- Tracks refund completions and customer disputes from PayPal's signed events.
- Parks a case for a person when a refund fails or a split across several captures is unclear.
Setup
Set it up
Create a PayPal REST app
In the PayPal developer dashboard, create a REST app for your business account and copy its Client ID and Client Secret.
Connect PayPal
An Owner or Admin pastes the credentials on the PayPal tile on the Integrations page and picks sandbox or live.
Let Lumtry check the credentials
Lumtry exchanges them for a token and looks up your merchant id before saving anything. Invalid credentials are not stored.
Publish a policy and watch first
Publish your refund rules, then run cases in shadow mode until the decisions match what you expect.
Data
What Lumtry reads
- The order and its captures, each in its own currency, to work out what is still refundable.
- Refund completion events, checked against PayPal's signature before anything is recorded.
- Customer dispute events, so a disputed payment flags its refund case.
What Lumtry writes
- Refunds against the original capture, each with a PayPal request id so a retry cannot pay twice.
- Dispute evidence, only after a person approves it, with the Dispute Automation add-on.
FAQ
Frequently asked questions
Where are my PayPal credentials kept?
In your workspace's secret store. The Client Secret is never shown again, and the dashboard shows only the last four characters of your merchant id.
Can I try it in the PayPal sandbox first?
Yes. Choose sandbox when you connect, and switch the environment on the PayPal tile when you are ready for live payments.
Does Lumtry ever charge a customer through PayPal?
Only with a saved PayPal wallet: for an exchange that costs more, or to reverse a refund a later step rolled back within 30 days. Without a saved wallet, Lumtry charges nothing and the case waits for a person.
Can Lumtry respond to PayPal disputes?
With the Dispute Automation add-on, on Starter and Growth or included on Scale. The evidence pack is built from data Lumtry already holds and is sent to PayPal only after a person approves it.
Keep reading