RiokobyKapta
Setup guide · November 2026
/ Guides · TOConline

Automatic invoicing in TOConline.

Every payment received on Shopify, Stripe, Lodgify, Easypay or EuPago becomes an invoice in your TOConline, and every refund a credit note. This guide shows, step by step, how to connect TOConline to Rioko.

Shopify Stripe Lodgify Easypay EuPago → TOConline
01What you need

Access to your company's TOConline (Empresa > Configurações), with the Gestão Comercial module active, and to your payment platform.

02Time

About 10 minutes, from start to the first document.

03Price

€7.50 + VAT per month or €75 + VAT per year, per integration.

BEFORE YOU START

What you need to have

Check these points before opening Rioko's wizard.

BEFORE YOU START

How it works

Your payment platform tells Rioko about each payment. Rioko creates the document in your TOConline through TOConline's official API, with the VAT, document type and finalization you choose. Access is granted once, in TOConline's Dados API, and Rioko keeps it alive on its own.

Shopify Stripe Lodgify Easypay EuPago
Payment

Your customer pays in your shop, booking or payment channel.

→
RiokobyKapta Rioko

Applies your rules: document type, VAT, exemption and finalization.

→
TOConline Document

One invoice per payment. A refund gives a credit note.

One invoice per payment

If the same payments are already invoiced in another program, through Rioko or another system, turn that invoicing off before activating this one: the same payment would end up with two invoices. In Rioko, a Stripe account invoices through one integration at a time.

About the images

The images in this guide come from a TOConline demo company and a Rioko test account, with the values replaced by examples. In your account you will see your own data. Click an image to see it full size.

01

Choose the integration in Rioko

At rioko.online, signed in.

  1. 1Open Integrations.
  2. 2Under Payment / E-commerce platform, choose your platform. Under Invoicing platform, choose TOConline.
  3. 3Click Configure now.
  4. 4Step 1 connects the payment platform. Each step's See how button and Rioko's Help show where each value is.
02

Request the API data in TOConline

TOConline grants API access company by company. You do this once.

  1. 1In TOConline, open the Empresa menu and, in the Configurações column, click Dados API.
  2. 2Name yourself as the integrator, with your own name and email, and confirm. TOConline asks for your two-factor authentication code.
  3. 3TOConline emails you a link that works for 72 hours. Open it: the page Dados de acesso à API do TOConline shows the Identificador (client ID), the Segredo (secret), the Endereço de autenticação por OAuth and the Endereço de acesso à API.
TOConline's Empresa menu, with Dados API in the Configurações column.
For a company that already has API data, the window offers «Reenviar detalhes de acesso à API», which sends the email again.
Careful

Treat the Segredo like a password: do not share it by email, chat or screenshots.

If the link expires before you use it, request it again with Reenviar detalhes de acesso à API.

Do not click Revogar acesso à API do TOConline: the integrations that use this data, Rioko included, stop working.

03

Paste the redirect address

On the «Dados de acesso à API do TOConline» page the email link opened. The API is only available with the company's Gestão Comercial module active.

  1. 1In the Endereço URI de redirect field, replace what is there with this address, character for character. It is the same for every account, and Rioko's step 2 shows it too, with a copy button:https://rioko.online/api/integrations/toconline-oauth/callback
  2. 2Save with the disk icon.
Dados de acesso à API do TOConline, with Rioko's redirect address. The values are examples.
Video: from the API data to the authorisation, with captions (no sound). The values are examples.
Do not press the circular arrows next to Segredo

They generate a new secret, and the old one stops working. If that happens, paste the new Segredo into Rioko's step 2 and click Authorise again.

04

Authorise TOConline

Back in Rioko, in step 2 of the wizard.

  1. 1Copy the four values from the TOConline page, with each field's copy button, into the fields with the same names in Rioko: Identificador (client ID), Segredo (secret), Endereço de autenticação por OAuth and Endereço de acesso à API.
  2. 2Click Authorise TOConline.
  3. 3TOConline asks you to confirm the access. Confirm: you return to Rioko, with TOConline authorised.
Step 2 in Rioko, on a connection already authorised: the redirect address and the four fields. On a new connection, the button reads «Authorise TOConline».
Good to know

Once saved, the values are not shown again. If TOConline stops accepting the connection (for example, after a new Segredo), the integration asks for attention: open step 2 and click Authorise again.

05

Invoice settings

Step 3 of the wizard.

Document type
Invoice-receipt by default on Stripe, Easypay and EuPago, because the payment arrives already received; Invoice by default on Shopify and Lodgify. On Easypay and EuPago you can choose Invoice + automatic receipt: the invoice is issued with the payment and the receipt right after.
VAT included
On, the amount paid already includes VAT.
Auto-finalize
Off by default: the document stays as a draft in TOConline, for you to check and finalize there. On, the document is finalized at once.
Email the invoice to the buyer
On, the finalized document is emailed to the buyer. A draft is never sent.
Exemption reason
Used on lines with 0% VAT. Without it, an exempt sale is not invoiced.
Recommendation

Leave "Auto-finalize" off for the first payments, to check in TOConline that everything is right, and turn it on afterwards.

Step 3: Invoice settings, in an integration with TOConline.
06

Activate and test

Check the first document before letting invoicing run on its own.

  1. 1On the same page, activate the integration's subscription (monthly or yearly).
  2. 2In step 4, click Mark as active.
  3. 3Make a small payment on your platform.
  4. 4On the Dashboard, the payment shows under Latest documents, with the document's status. Open the document in TOConline and check totals, VAT and customer.
Latest documents: one payment per row, with the reference, the amount and the document's status in TOConline.
TOConline has no test mode

A test payment from your platform (for example, in Stripe's test mode or in the Easypay or EuPago sandbox) always stays as a draft in TOConline. Delete it there once you have seen it.

All good?

If you left "Auto-finalize" off, turn it on in step 3. From then on, every payment is invoiced automatically.

FREQUENTLY ASKED QUESTIONS

Frequently asked questions

Which TOConline licence do I need to connect to Rioko?

The API is only available with the company's Gestão Comercial module active.

Where do I request the TOConline API data?

Under Empresa, Configurações, Dados API. TOConline emails you a link valid for 72 hours.

Does TOConline have a test mode?

No. A test payment from your platform always stays as a draft in TOConline. Delete it there once you have seen it.

What happens if I generate a new Segredo?

The previous one stops working. Paste the new one into Rioko's step 2 and click Autorizar outra vez (Authorise again).

Why does Rioko not show my series?

Rioko only lists series reported to the AT. See Report series in TOConline.

CONTINUE

Related guides

Connect TOConline to the AT

Create the AT sub-user and enter the credentials.

See the guide →

Report series in TOConline

Create and report the series.

See the guide →

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 →

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
RiokobyKapta