On this page
How to use this article
Find the message you see in Benji Pays in the tables below. Messages are quoted as they appear so you can search this page. Where a fix has its own article, the title is given in bold.
NOTE This feature is currently in beta and is subject to change.
Connecting and reconnecting
| Message | Cause | Fix |
|---|---|---|
| Error connecting to Business Central. Please try again. | Microsoft sign-in did not complete, consent was declined, or your tenant requires admin approval | Try again. If Microsoft showed "Need admin approval", have your Microsoft 365 administrator grant admin consent, see Business Central Permissions and Prerequisites. |
| No Business Central companies found. Please ensure you have access to at least one company. | The signed-in user has no Business Central company access, or every company is already connected to another Benji Pays account | Sign in with a user who has access, or check which Benji Pays account already owns the company. |
| No companies found in this environment. | The chosen environment has no companies visible to this user | Choose a different environment or ask your administrator for access. |
| Business Central environment is required. | Continue was selected before choosing an environment | Select an environment, wait for companies to load, then continue. |
| Invalid Business Central credentials. Please check your Tenant ID, Client ID, and Client Secret. | Service-to-service values are wrong, the secret expired, or the application is not registered and enabled in Business Central | Re-check the three values, create a new secret if expired, and confirm the application on the Microsoft Entra applications page in Business Central has permission sets and State = Enabled. |
| Red banner: We are unable to connect to your accounting system. Please click the button below to re-authorize BENJI PAYS to connect to your accounting system. | The token expired or was revoked (password change, user removed, secret expired) | Select Setup Business Central connection and sign in with a user who can access the same company. See Connect Microsoft Dynamics 365 Business Central. |
| Business Central is disconnected. Please reconnect first. | A support action was attempted while the company is disconnected | Reconnect from Company Settings first. |
[SCREENSHOT: Company Settings showing the red connection banner and the "Setup Business Central connection" button.]
Invoices and Auto Processing
| Message or symptom | Cause | Fix |
|---|---|---|
| The following invoice(s) have not been posted in Business Central yet. Please post them before attempting to collect payment: S-INV102609 | The invoice is still a draft, pending approval or released | Post the invoice in Business Central, then retry. |
| Invoice missing from Benji Pays | Not posted, or sync delay | See How Business Central Data Syncs with Benji Pays. |
| Auto Processing skipped an invoice | Invoice number prefix filter, Reference Field Skip, disabled payment terms, invoice date or amount skip, or the invoice is unposted | Review Invoice Skip Settings in Company Settings; see Business Central Invoices: Posted vs Unposted, Statuses, and the Invoice Number Prefix Filter. |
| Credit memo auto-apply is not supported for Business Central via API v2.0. Apply credit memos to invoices manually in Business Central. | Process Credit Memos or Apply Credit Memos is enabled | Apply the credit memo to the invoice in Business Central before the invoice is processed. See Credit Memos with Business Central. |
| Warning: Action required: review before enabling Auto Processing | Shown to every Business Central company when enabling Auto Processing | Not an error. Confirm your prefix filter settings and continue. |
Recording payments
For these messages the customer's card or bank may already have been charged. Check the transaction result in Benji Pays before retrying.
| Message | Cause | Fix |
|---|---|---|
| A Business Central payment journal must be configured before enabling this gateway. Go to Business Central Settings to set up the journal mapping. | The gateway has no Cash Receipt Journal | Assign or create a journal in Settings > Business Central Settings, then enable the gateway. See Business Central Settings: Cash Receipt Journals and Auto-Posting. |
| This gateway does not have a Business Central payment journal configured. Payments cannot be applied until a journal is mapped. | Same as above, shown on the gateway edit page | Same as above. |
| Business Central payment journal is currently busy. Please retry. | Another Benji Pays payment or void was posting to the same journal at the same moment | Retry in a minute. Consider one journal per gateway. |
| Cash Receipt Journal "..." was not posted automatically but was created in Business Central (document number ...). To post, open Business Central, go to Cash Receipt Journals, and post the journal manually. | Auto-posting is turned off | Post the journal in Business Central, or turn on Automatically post cash receipt journals to General Ledger. |
| Cash Receipt Journal "..." was not posted automatically because journal locking is unavailable... | Benji Pays could not obtain its posting lock | Post the journal manually in Business Central. |
| Email: Action Required: Payment Journal Deleted in Business Central | A journal batch used by a gateway was deleted in Business Central; the gateway was disabled | Select or create a new journal in Business Central Settings and re-enable the gateway. |
| Unable to load cash receipt journals from Business Central. | Temporary API error or broken connection | Select Retry; if it persists, reconnect Business Central. |
| Business Central has no USD exchange rate effective on ... or ...exchange rate is stated against ... instead of ... | Missing or mis-stated exchange rate | See Multi-Currency Payments with Business Central. |
| BC surcharge clearing account is not configured. Configure the refund/clearing account for this gateway currency in gateway settings. | Refund Account not mapped for the currency | Map it in Payment Gateway Settings. |
| Transaction message beginning Error applying payment in Business Central followed by a Business Central error | Business Central rejected the journal line or the post | Read the Business Central text: common ones are a posting date outside the allowed posting period (General Ledger Setup or the user's posting range), a mandatory dimension missing on the customer or balancing account, a blocked customer or account, or a closed accounting period. Fix the setup in Business Central, then record the payment manually or contact support to have Benji Pays re-apply it. |
Voids and refunds
| Message | Cause | Fix |
|---|---|---|
| Payment Applied in Business Central / This payment has been posted and applied to one or more invoices in Business Central. Please unapply the payment in Business Central, then retry the void. | The posted payment is applied to an invoice | Unapply in Business Central (select all rows in the Unapply dialog), then select I've Unapplied - Re-check Now. See Voiding and Refunding Payments with Business Central. |
| The original payment lines could not be found in the Business Central journal... | Lines were posted or deleted outside Benji Pays | Verify in Customer Ledger Entries and choose the appropriate option in the dialog. |
| Benji could not confirm the payment state in Business Central... | Finance reports API unavailable, or a transient error | Install API Reports - Finance and enable Allow HttpClient Requests; verify the payment manually. |
| Please select a credit memo or overpayment to apply this refund to. | The credit memo refund option is enabled, and the live list for that customer is empty. Benji Pays lists credit memos that still have a remaining amount after subtracting amounts already recorded on other Benji Pays refunds. | Post a credit memo in Business Central with enough remaining credit, then retry. If the credit memo option is turned off, the refund is non-integrated and this dropdown is not shown. |
| BC payment journal not configured for gateway. Configure bcPaymentJournalId in Business Central Settings. | Refund attempted on a gateway without a journal | Assign a journal in Business Central Settings. |
| Refund journal line created in Business Central for ... Apply to the credit memo in Business Central if it remains open. | Informational | Apply the refund entry to the credit memo with Apply Entries in Business Central. |
Errors reported by Business Central itself
If a Business Central error mentions 403 Forbidden, 404 Not Found on customerLedgerEntries, or missing permissions, the connecting user or application lacks a permission set or the API Reports - Finance extension is not installed or does not allow HTTP requests. Share Business Central Permissions and Prerequisites with your administrator.
Contacting support
When you contact Benji Pays support about a Business Central issue, include the Benji Pays transaction reference, the invoice number as shown in Business Central, the exact message text, and the Business Central environment name. Support can check the Business Central webhook subscriptions and API logs for your company.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article