| Symptom |
Likely cause |
What to do |
| The app detects no payments |
No notification access, or the system killed the app |
Grant the permission; exclude the app from battery optimization; check the heartbeat in the panel |
Activation code fails (404/410) |
Expired (15 min), used or mistyped |
Generate a new one in the panel |
Activation rejected (403) |
License suspended or device limit reached |
Check the license; remember activating another phone replaces the previous one |
401 when sending events |
Invalid credential or phone clock skew |
Fix the time; if it persists, reactivate the phone |
Event stays SUSPICIOUS |
No order, different amount or ambiguous |
Review it in the panel and assign it by hand |
| Payment after the order expired |
LATE_PAYMENT |
Decide: reactivate the order or refund |
| The order does not change in Magento |
Policy is on Shadow |
Expected; move up a mode once you have data |
Events don’t show up in live |
test keys on that website |
Use the sk_live_… keys |
| “Connector offline” alert |
Magento cron stopped or key revoked |
Check the cron and the website’s key |
| I lost the secret key |
It is only shown when created |
Create a new one, update the connector and revoke the old one |