Skip to content
Van Oosten Advies B.V.

Last updated: 17 November 2026

Online payments in CustomerGate 365

Since version 1.1.0 a customer can pay an open invoice online: in the customer portal, or through the pay link in the invoice e-mail. The money goes to your own account at the payment provider, Stripe or Mollie, with your own API key. Business Central makes the payment page, learns from the provider itself that the invoice was paid, and posts the payment against the invoice. No card data reaches Business Central, and Van Oosten Software takes no fee on a payment.

How a payment goes

  1. The buyer chooses to pay an open invoice, in the portal or on the page behind the pay link.
  2. Business Central makes a payment page at the provider for what is still open on the invoice, less a payment discount that still applies today. The buyer pays there, by card, iDEAL, Bancontact or whatever you switched on in your account at the provider.
  3. The buyer returns to the website on the Payment Success URL, which carries the ID of the payment. The website asks Business Central what became of it, and Business Central asks the provider: it never takes the website's word or a redirect for the fact of a payment.
  4. The payments job posts the payment as a cash receipt applied to the invoice, against your balancing account, with the provider's fee where the provider reports it.

The website's account starts a payment and learns what became of it, and can post nothing: it has no right on any journal or ledger. Posting is done by the payments job, with the rights of the user who runs it, or by a person who chooses Post on Website Payments. A payment row holds amounts, document numbers and the provider's own IDs, and no card data or personal data.

In the portal and through the pay link

Payments are in every plan. Where a buyer can pay depends on the plan:

In the customer portal
In the plans Portal and Complete. The portal lists the customer's posted invoices and credit memos with what is still open on each, and offers to pay an open invoice. An invoice can be paid when it is open, its customer ledger entry is not On Hold, its currency is one the provider takes and something is left to pay, and when its customer is not blocked for everything and not Privacy Blocked.
Pay Link Address
In every plan, and the way to pay in the plan Requests, which has no portal. The address of the pay page of your website, for example https://www.example.com/pay/. With it every posted invoice gets a pay link of its own, for the invoice e-mail and the printed invoice. The standard sales invoice report carries the link as the column VOAPayLink, for a Word layout or an e-mail body; without the address that column stays empty.

A pay link does not change. Its token is the invoice number with a keyed hash over it, made with a secret of this company, so nothing is stored per invoice and an invoice printed again later still carries a working link. Whoever holds the link can pay that invoice and sees its number and open amount, nothing else of the customer. A link that was changed or made up is refused.

Setting it up

  1. Open an account at Stripe or Mollie and switch on the payment methods you want there.
  2. Allow the app to make outgoing calls: on the Extension Management page choose CustomerGate 365, then Configure, and turn on Allow HttpClient Requests. Business Central calls the provider itself.
  3. On CustomerGate Setup, under Payments, choose the Payment Provider and then Set Payment API Key. The dialog Payment Provider API Key says under Where to Find It what a key of that provider looks like. The key is stored encrypted where the environment can and is never shown again; the line API Key then says whether a key is stored and whether it is a test key.
  4. Fill in Payment Success URL and Payment Cancel URL, the two pages of your website a buyer returns to.
  5. Fill in where payments are posted: Payment Balancing Account Type and Payment Balancing Account No. (the bank account or G/L account that holds your balance at the provider until it pays out), Payment Journal Template and Payment Journal Batch (a cash receipt journal; a batch of its own keeps its numbers recognizable), and Payment Fee Account No. for the provider's fee.
  6. Fill in Pay Link Address if your invoices should carry a pay link.
  7. Choose Payments Job and set it to Ready, as a user who may post cash receipts. It is created On Hold, because it posts money.
  8. Choose Test Connection and check the lines under Payments.

The setup guide has a step Online Payments for the provider and the key; the return addresses and the posting settings stay on the setup page. Without a key payments are simply not in use: nothing is offered for payment, and Diagnostics says so as information, not as a failure.

Test keys, live keys and changing provider

  • In a sandbox only a test key is accepted, so a copy of production never takes real money. A live key that came along with a copy of production is not used there, and copying an environment clears the key of every provider.
  • In production a test key works, but buyers then pay on the provider's test page without real money, and Business Central never posts such a payment. Diagnostics and the setup page warn while a test key is stored in production.
  • Every provider has its own key. Choosing another provider keeps the earlier key, so payments that are underway there are still finished with the provider that started them. When the new provider has no key and the earlier one has, the page asks first, because from that moment no invoice can be paid online until you enter a key.
  • Remove Payment API Key removes the key of the chosen provider. Invoices can then no longer be paid online; payments that are underway are recorded once a key is back.

The payments job

The payments job runs every five minutes. Each payment is handled in a transaction of its own, so one payment that fails does not stop the others. A round does three things:

  1. It asks the provider about every payment that is started or processing, so a payment is known also when the buyer never came back to the website.
  2. It looks through the provider's payments of the last day for one that Business Central started and never got an answer about, and records it.
  3. It posts every paid payment as a cash receipt applied to its invoice.

While the job is not Ready, a payment is only recorded when the website confirms it, and nothing is posted. The job does nothing while the return addresses or the posting settings are missing.

How a payment is posted

  • With the date the buyer paid, as the provider reports it in Provider Paid At, so a payment discount depends on that day and not on the day Business Central learned of the payment. An invoice with a later posting date than the day of payment gets the payment on its own posting date, because Business Central applies no payment to an invoice dated after it. When the day is closed for posting, the payment is posted on the first open day after it, with the discount of the day of payment.
  • Stripe reports its fee with the payment. The fee is posted to Payment Fee Account No. against the balancing account, so the balancing account matches what Stripe pays out. Without a fee account the fee is not posted and Fee Note says so; a fee in a currency Business Central does not have stays unposted with the reason.
  • Mollie reports no fee with a payment. A Mollie payment is posted without a fee line, Fee Note says so, and the fees are booked from Mollie's settlement.
  • A payment the provider took in another currency than the invoice is marked Post Manually and is never posted by Business Central. Book what the provider pays out in a cash receipt journal and apply it to the invoice, or refund it in the provider's dashboard.
  • Posting needs the rights to post a cash receipt, which CustomerGate neither grants nor elevates: the user of the payments job needs them, and so does the person who chooses Post.

Website Payments

Website Payments (Payments on CustomerGate Setup) lists every online payment, newest first. The rows come from the portal, the pay link and the provider's answers only; nothing on it can be typed in or changed by hand.

Status
Started (a payment page was made), Processing (the buyer paid with a method that takes days, such as a bank debit; the invoice is not offered again meanwhile), Paid (the provider confirmed it; the job posts it next), Posted, Not Posted (the reason is in Error) or Expired (the page closed without a payment, or the payment failed).
Started At, Paid At, Provider Paid At, Posted At
When the buyer chose to pay, when Business Central learned that the invoice was paid, when the buyer paid according to the provider, and when the payment was posted. Provider Paid At decides the posting date.
Document No., Customer No., Currency Code, Amount
The invoice, its customer and the amount: what was open when the payment started, then what the provider confirmed.
Posted Document No., Error
The document number of the posted payment, or why the payment could not be posted or was closed without being paid.
Fee Amount, Fee Posted, Fee Note
The fee the provider kept, whether it was posted with the payment, and why not, so that it can be booked by hand.
Provider, Provider Reference
The provider that started the payment and finishes it, also after another one is chosen in setup, and its reference to find the payment in the provider's own dashboard.
Test Payment, Post Manually, Unreachable Since
A payment made with a test key; a payment taken in another currency than the invoice; and since when the provider cannot be asked about this payment.
Check with Provider
Asks the provider now about the selected payments that are started or processing, instead of waiting for the payments job.
Post
Posts the selected payments that are paid or not posted, with your own posting rights. Use it after fixing what the Error column names. A payment marked Post Manually, and a test payment in production, are never posted here.
Close without Asking Provider
Only for a payment that is started or processing and whose provider cannot be asked. See below.
Show Invoice, Show Customer Ledger Entry
Opens the posted sales invoice, or its customer ledger entry with what is still open on it.

When a payment goes wrong

The buyer does not pay
The payment page closes, and the payment becomes Expired. The invoice can be paid again; a new choice to pay hands out the page that is still open or makes a new one for what is open at that moment.
The payment fails
A payment that is cancelled, or a bank debit the bank refuses later: the payment becomes Expired with the reason, and the invoice can be paid again at once.
The payment takes days
A bank debit that is underway: the payment stays Processing, the invoice is not offered for payment again, and the job keeps asking until the money is there or the debit failed.
The buyer does not come back
The payments job asks the provider anyway and records the payment.
The answer got lost
When Business Central never got the provider's answer, the job finds the payment among the provider's payments of the last day, by the ID of Business Central's own that the payment carries, and records it.
The payment cannot be posted
A closed period, a blocked customer, an invoice that was closed in the meantime: the payment becomes Not Posted with the reason in Error, Diagnostics counts it, and nothing is lost. Fix what it names and choose Post. To an invoice that is no longer open no payment is applied: book it by hand, or refund it in the provider's dashboard.
The provider cannot be asked
The key of that provider was removed, or the provider answers that it does not know the key or the payment: the payment gets Unreachable Since and the reason. It stops holding its invoice once its page can no longer take money, a day after it was started at the latest; a bank debit that is underway keeps holding it. Every payment that is underway is closed 30 days after it was started, whether or not the provider answers. Once the key is back, the job asks again.
Close without Asking Provider
Closes such a payment at once, after a question. Business Central then never learns whether the buyer paid on that page: look the payment up in the provider's dashboard first, and book or refund a payment that was made by hand.

What Diagnostics says

The connection test, on CustomerGate Diagnostics and behind Test Connection, has a group Payments:

LineWhat it means
Payment provider keyInformation without a key: payments are not in use. Passed with a live key. Warning with a test key in production. Failed with a live key in a sandbox, which is not used there.
Payment providerInformation, only with a key: the provider new payments go to.
Payment currencyInformation: the currencies that can be paid online with this provider. Failed when the local currency is not among them. An invoice in any other currency is not offered for payment.
Payment setupFailed while the return addresses, the balancing account or the journal template and batch are missing: invoices cannot be paid online.
Payments jobWarning while the job is not Ready, failed when it does not exist: payments are then only recorded when the website confirms them, and nothing is posted.
Payments not postedWarning with a count: payments that are recorded and not in the books. The Error column of each says what to do.
Payments underway at (the provider) without a keyWarning with a count, per provider: payments that were started at a provider whose key is no longer stored, so nobody can ask what became of them. Choose that provider again, enter its key, let the payments job run, and choose the other provider again.

The checklist of the setup guide has a line Payments that sums up the same checks. Diagnostics shows counts and states only, never an invoice, a customer or an amount.

Related help