How to set up Eupago on Moloni ON
What is Eupago and what is it used for?
Eupago is a Portuguese Payment Institution, duly authorised and supervised by the Banco de Portugal (registration no. 8709). Focused on the fintech ecosystem, the company develops financial technology solutions to optimise payment collection for companies and online businesses.
Eupago's goal is to allow any business (whether B2C or B2B) to offer its customers the most widely used payment methods in Portugal and across Europe - such as MB WAY, Multibanco Reference, and Credit Cards (Visa and Mastercard).
Integrated with Moloni ON, the Eupago service automatically generates payment details and direct links (PayByLink) on the invoices sent to customers, synchronising the settlement status in real time without the need for manual reconciliations.
Follow these steps:
1. Access Settings on the left menu of Moloni ON, click Other settings, and select Payment gateways.
2. Review the available options on the page and, if you do not have an account or contract yet, open the Eupago registration form through the link inside your desired method.
3. Fill in the mandatory fields on the form and click Registar. Once your details are submitted, the process with Eupago will begin. As soon as it is complete, you will receive an email with the login details for the contracted services.
4. Access the Eupago back office with the credentials you received.
5. In the side menu, under Gestão, go to Canais and click Adicionar Canal. This creates the API key to be used for the services between Moloni ON and Eupago.
6. Fill in the requested details and click Adicionar Canal.
7. In the channel list, you can view the API keys. Copy the desired key to insert it into Moloni ON.
8. Return to Moloni ON and click the Activate button.
9. In the Title field, enter an identifying name for this configuration (e.g., "Eupago: PayByLink").
10. Enter the API key into the API key field.
11. Enable the Default option if you want this to be the standard payment method suggested on your Moloni ON documents.
12. Click the Save button (in the top or bottom right corner) to get your anti-phishing key and activate the automatic Callback for real-time payment recording.
How do I generate receipts automatically on Moloni ON?
Setting up automatic receipt generation between Moloni ON and Eupago ensures your accounting stays up to date without manual effort.
Follow these steps:
1. Access Settings on the left menu of Moloni ON, click Other settings, and select Payment gateways.
2. Under Active gateways, click View details on the block of the Eupago method you wish to configure (e.g., Eupago: PayByLink or Eupago: Multibanco).
3. Copy the link that appears in the Callback field.
4. Access your Eupago customer portal and, in the left side menu, under the Gestão section, select Canais and click Listagem de Canais.
5. Identify the relevant account in the table and click Editar.
6. Enable the Receber notificação para um URL checkbox.
7. In the URL field, insert the Callback obtained in Moloni ON.
8. Click Guardar to save the connection.
9. Return to the method settings page in Moloni ON and select the Optional settings tab at the top of the screen.
10. Enable the Automatically generate receipts option.
11. In the Document set field, select the document set from the drop-down menu where you want your receipts to be issued.
12. In the Payment method field, select your preferred method.
13. Click the Save button in the bottom right corner to complete the process.
How do I add payment details to a document?
To simplify the collection process and automate financial management, Moloni ON allows you to integrate payment gateways directly into your documents. When you activate this option, the system automatically generates the payment details associated with your configured financial entity - Multibanco references or direct links (PayByLink) - allowing your customer to pay with total convenience.
However, there are specific rules regarding where and when you can use this feature in Moloni ON. Make sure you meet the following requirements:
- Eligible documents: Payment details can only be added to Invoices and Recurring Agreements. They are not available for other document types.
- Workflow flexibility: You can include the payment right at the time of issuance or add it later to a document that has already been closed.
During the creation of a document
If you are issuing a new invoice or recurring agreement and want the customer to receive the payment link straight away, follow these steps:
1. After filling in the Commercial information and Products, go to the Generate payment data section and select your desired payment gateway.
2. In the Value field, enter the exact amount to be charged through the gateway.
3. Click Save and finish in the bottom right corner. Moloni ON will issue the document and immediately create the link or the reference in the Payments tab with a Pending status.
On an already issued document
If the document has already been generated without payment details and you want to add the link now, follow these steps:
1. Open the desired invoice or recurring agreement and click the Payments tab.
2. Click the Generate payment button in the top right corner of the tab.
3. In the Generate payment data section, select your desired payment gateway.
4. In the Value field, enter the amount to charge. You can use the total outstanding amount of the document, shown under Total value. Validate the details and click the Generate payment button to create the corresponding payment link or reference.
Status automation
As soon as the document is paid by the customer via the link or the reference, the status in the Payments tab automatically changes from Pending to Paid (with Callback active).