Troubleshooting
Common issues you may run into and how to resolve them.
Troubleshooting
If something looks wrong, work through the section that matches your situation. Most issues are resolved without contacting support.
A payment is not matching
Reconbanker only matches a bank transaction to a payment when all of these are true:
- The amount is exactly the same (no tolerance).
- The currency is the same (Reconbanker does not convert FX).
- The bank transaction was received no more than 5 days before the payment was registered.
- The sender name on the bank transaction is similar enough to the name on the order.
What to check:
- Open the request in the dashboard. The detail view shows every attempt with a reason.
- Confirm the amount and currency on your order match the transfer exactly.
- Look at the sender name on the bank transaction. If it is wildly different from the name on the order, ask the payer to send with a clearer reference.
- If you believe the right transaction is in the account, press Run match now on the request.
A request is stuck in "pending"
The request was created but no bank transaction has matched yet. Possible reasons:
- Reconbanker has not run a bank scrape since the order was registered. Wait for the next cycle or press Run scrape now on the account.
- The transfer simply has not arrived yet. That is fine, the request will wait until it does or until it expires.
- Your account is missing settings. Open Settings and confirm the webhook URL and (in reconcile mode) the pending orders endpoint are filled in.
The result is "ambiguous"
Reconbanker says a payment is ambiguous when two or more bank transactions are equally plausible matches. By design, Reconbanker will not pick for you in that case.
To resolve:
- Open the request in the dashboard and review the candidate transactions.
- Decide which one is correct and mark it manually from the dashboard, or contact the payer for clarification.
- If you keep seeing ambiguity from the same sender, ask them to add a unique reference (an invoice number, for example) so future transfers can be told apart.
Bank login failed
Reconbanker could not log into your bank to read transactions.
- Most often the password changed. Open Settings → Bank credentials and re-enter your username and password.
- Reconbanker does not support banks that require a second factor (SMS, push, captcha) at every login. If your bank enforces MFA, the account cannot be scraped. Contact support — some banks offer an app password or read-only token that avoids the prompt.
- If the credentials look correct, try logging into the bank's website yourself. If you are blocked there too, sort that out first.
A webhook did not fire
Check the following in order:
- Open the request (or bank transaction) in the dashboard and look at the delivery attempts.
- Confirm the Webhook URL in account settings is reachable from the public internet and returns a 2xx response.
- Confirm your
Authorizationtoken, if any, is still valid on your side. - Reconbanker retries up to 3 times with exponential backoff (5 seconds, 10 seconds, 20 seconds). After that the delivery is marked failed.
- Press Resend webhook to replay the delivery once you have fixed the receiver.
A request expired after 5 days
Reconbanker automatically expires any pending request older than 5 days. If you want to be notified when this happens, turn on Notify on expired in account settings. Reconbanker will fire your webhook with status: "expired" so your system can update accordingly.
If a transfer arrives later for an expired request, you can re-register the order and it will match the bank transaction normally.
I need to talk to a human
Email support at ignaciogarcia.code@gmail.com.