Getting paid
Set up LHV LinkPay for invoice payments
Let customers pay EUR invoices from their invoice page. You need an LHV merchant account with LinkPay access and owner or administrator permissions in Aeglio.
The short answer
Create one reusable LinkPay link, connect it to Aeglio and add the notification URL in the merchant portal. Aeglio fills in the payment details for each invoice.
1. Create a LinkPay link
In LHV Merchant Portal, open LinkPay → Links → Add Link. Give the link a name such as Aeglio invoices and select a EUR processing account.
Keep subscription mode off. Avoid expiry or payment-count limits that would prevent using the link for future invoices.
2. Configure the payment fields
Enable the four fields below. For each, turn URL Changeable on and Customer Changeable off so Aeglio can supply the values and the customer cannot edit them.
- Amount (transaction_amount) — the outstanding invoice balance.
- Invoice number (invoice_number) — the invoice being paid.
- Order reference (order_reference) — Aeglio’s identifier for the payment attempt.
- Reference number (reference_number) — optional; leave Required off. Aeglio sends only a valid ISO 11649 RF reference, not a domestic 7-3-1 reference.
- Keep order-reference uniqueness enabled in E-Shop Settings, then save the link.
3. Connect in Aeglio
Open your team’s Integrations settings, find LHV LinkPay and choose Manage. Enter the API username and API secret from the merchant portal’s general settings, plus the LinkPay token from your saved link. Enter the token, not the whole payment URL.
Confirm the configuration checklist and select Test credentials and connect. This checks access; it does not take a payment. The modal stays open after saving.
4. Add the notification and return addresses
Copy Callback notification URL from the saved connection in Aeglio. In the merchant portal, select your e-shop, open Payments and paste it into Callback Notification URL. Save the settings.
This lets Aeglio verify and record payments even when the customer closes the payment page. Keep the address private and update it in the portal if you reconnect. If another application already uses that notification field, check with its administrator before replacing it.
Also copy Customer URL from the Aeglio modal. In LHV Merchant Portal, open LinkPay → Links → select your link → Customer URL, paste the address and save. Configure both addresses: this one brings the customer back to the invoice, while notifications work even if they close the browser.
On returning, the invoice briefly shows "Confirming your payment" and updates automatically when confirmation arrives.
5. Enable payments on your invoices
Turn on Online payments enabled inside the LinkPay modal. An open EUR invoice with an unpaid balance and an active public share link can now offer online payment.
Send the invoice as usual. The customer opens it and chooses Pay online. If you offer more than one eligible payment provider, the customer chooses which to use. Aeglio records payment after verifying it with LHV.
The PDF also has a clickable Pay online QR code. It opens a short payment screen with the current balance, not the full invoice. The public invoice page uses its payment button instead.
Sources
Frequently asked questions
- Why is the payment button missing?
- Check that online payments and public invoice sharing are enabled, the invoice is in EUR and it still has an unpaid balance. Draft or fully paid invoices cannot start checkout.
- The customer paid, but the invoice is still unpaid. What should I do?
- Check the payment in the merchant portal and the notification address first. Contact support if the status does not update; do not ask the customer to pay again before checking the original payment.