by
Automatic invoicing for Easypay.
With Rioko, every payment received on Easypay by Multibanco, MB WAY, card or direct debit becomes an invoice in your program (InvoiceXpress, Moloni, Vendus or TOConline). You connect with an Easypay API 2.0 key and a notification address.
Access to the Easypay backoffice and your invoicing program set up.
About 10 minutes, with your invoicing program already set up.
€7.50 + VAT per month or €75 + VAT per year, per integration.
What you need to have
Check these points before opening the wizard.
- Access to the Easypay backofficeAt backoffice.easypay.pt, to create the key and enter the notification address.
- Generic - URL field availableEasypay has only one Generic field per payment account. If it already holds the address of a store plugin, talk to us before replacing it.
- Invoicing program set upInvoiceXpress, Moloni, Vendus or TOConline, connected to the Portuguese tax authority (AT) and with a registered series. Each program has its own guide: InvoiceXpress, Moloni, Vendus and TOConline.
When Easypay collects payment for invoices you already issue in another program, such as Multibanco references generated by your invoicing program, or when the store is already invoiced by Rioko. The same payment would end up with two invoices.
- 1Open Integrações.
- 2Under Plataforma de Pagamento / E-commerce, choose Easypay. Under Plataforma de Faturação, choose your program.
- 3Click Configurar Agora.
Create the API 2.0 key
A key just for Rioko, with no IP restriction.
- 1In the Easypay backoffice, open Developers, Configuration API 2.0.
- 2On the payment account's row, click Keys and create a new one, named Rioko.
- 3Paste the AccountId and the ApiKey into step 1 of the wizard.
Paste the notification address
After you save the key, Rioko shows an address unique to your connection.
- 1Copy the address Rioko shows.
- 2In Easypay, under Developers, Configuration API 2.0, open Notifications.
- 3Paste it into Generic - URL and save. The Payment and Authorisation fields are not needed.
- 4The wizard checks with Easypay that the address is correct.
Connect the invoicing program
The next step of the wizard asks for your program's details.
- InvoiceXpress
- Account name and API key. See the InvoiceXpress guide.
- Moloni
- Authorisation on Moloni's own page. See the Moloni guide.
- Vendus
- API Key. See the Vendus guide.
- TOConline
- API data, with authorisation on TOConline's own page. See the TOConline guide.
Invoice settings
Easypay does not send the payment's VAT, so you enter it here.
- VAT rate
- The rate at which each payment is invoiced. With no rate entered, it is 23%. With 0%, also enter the exemption reason.
- Series
- The series in your program. In Vendus, the till. In TOConline, the company's default.
- Document type
- The document issued for each payment.
- Finalization
- Whether documents stay as drafts or are issued finalized. Vendus has no drafts.
Activate and test
Check the first document before letting invoicing run on its own.
- 1Activate the integration's subscription (monthly or yearly). A card is required.
- 2In the last step, click Marcar como Ativo (Mark as active).
- 3When the next payment comes in, open the Dashboard and, under Últimos documentos, see the document's status.
- 4Open the document in your program and check totals, VAT and customer.
Frequently asked questions
Which Easypay payments are invoiced?
Those where the money comes in: one-off payments, frequent charges and each cycle of a subscription. A reference that is still unpaid is not invoiced.
Why does a direct debit take time to be invoiced?
Easypay only confirms a direct debit a few days after the charge. The invoice is issued when the money is confirmed, with the date of that confirmation.
What is the VAT rate on the invoice?
The one you enter in the connection, because Easypay does not send the VAT. With no rate entered, it is 23%. With 0%, you also enter the exemption reason.
What happens with a refund or a chargeback?
Each refund creates its own credit note, as long as the invoice is finalized. A chargeback raises an alert, with no automatic credit note.
I use an Easypay plugin in my store. Can I connect Rioko?
The plugin may be using the same Generic - URL field. If it holds the plugin's address, replacing it can disconnect the plugin. Talk to us before changing it.
Where do I find the Easypay AccountId and ApiKey?
In the Easypay backoffice, under Developers, Configuration API 2.0, on the payment account's row.
Related guides
InvoiceXpress
Requirements and steps to connect InvoiceXpress to Rioko.
See the guide →Moloni
Requirements and steps to connect Moloni to Rioko.
See the guide →Vendus
Requirements and steps to connect Vendus to Rioko.
See the guide →TOConline
Requirements and steps to connect TOConline to Rioko.
See the guide →Need help?
If you would rather set it up with us, book a call. We configure everything with you, live.
Book a call ↗ calendly.com/pedro-kapta/rioko-support
by