by
Faturação automática dos pagamentos EuPago.
Cada pagamento recebido pela EuPago passa a dar uma fatura no InvoiceXpress, no Moloni, no Vendus ou no TOConline, e cada reembolso uma nota de crédito. Com os pedidos de pagamento, a fatura sai em nome do seu cliente, com o NIF. Este guia mostra, passo a passo, como ligar o seu canal EuPago ao Rioko.
→
Acesso ao backoffice da EuPago e ao seu programa de faturação: InvoiceXpress, Moloni, Vendus ou TOConline.
Cerca de 10 minutos, do início ao primeiro documento.
7,50 € + IVA por mês ou 75 € + IVA por ano, por integração.
Como funciona
A EuPago avisa o Rioko de cada pagamento no momento em que é confirmado, pelos Webhooks 2.0 do seu canal. O Rioko confirma que o aviso veio desse canal e cria o documento no seu programa de faturação, com a série, o IVA e a finalização que definir.
Pagamento
O seu cliente paga por Multibanco, MB WAY, cartão ou outro meio do seu canal EuPago.
by
Rioko
Confirma a assinatura do aviso e aplica as suas regras: série, IVA, isenção e finalização.
Uma fatura por pagamento. Um reembolso dá uma nota de crédito.
A EuPago não envia o nome, o email nem o NIF de quem paga, por isso um pagamento cobrado diretamente na EuPago é faturado a «Consumidor final». Para faturar em nome do cliente, com o NIF, crie o pagamento no Rioko, em Pedidos de pagamento (passo 07).
Não ligue esta integração se a EuPago cobra faturas que já emite noutro programa (por exemplo, referências Multibanco geradas pelo seu programa de faturação), nem se o canal já tem outro sistema a faturar os pagamentos: o mesmo pagamento ficaria com duas faturas.
As imagens deste guia são de uma conta de demonstração da EuPago e de uma conta de testes do Rioko. Na sua conta vai ver os seus dados: canais, empresa, séries e o endereço da sua ligação. Clique numa imagem para a ver em tamanho real.
- 1Abra Integrações.
- 2Em Plataforma de Pagamento / E-commerce, escolha EuPago. Em Plataforma de Faturação, escolha InvoiceXpress, Moloni, Vendus ou TOConline.
- 3Carregue em Configurar Agora.
- 4No passo EuPago, em 1. Endereço para a EuPago, carregue em Copiar. O endereço é único para a sua conta: vai colá-lo na EuPago no passo 02.
Ativar os Webhooks 2.0 na EuPago
Os Webhooks 2.0 configuram-se em cada canal, no backoffice da EuPago (clientes.eupago.pt).
- 1Abra Canais → Listagem de Canais e carregue em Editar no canal que recebe os pagamentos.
- 2Desça até Webhooks 2.0 e marque a caixa.
- 3Em Software Integrado, escolha Integração Personalizada.
- 4Em Webhook Endpoint, cole o endereço que copiou do Rioko.
- 5Em Tipo de Webhook, escolha Pagamento e Reembolso. Deixe Encriptar Webhook em Sim.
- 6Carregue em Gerar Chave Criptográfica e confirme. Mostre a chave com o ícone do olho e copie-a.
- 7Carregue em Guardar e confirme em Editar.
Trate a Chave Criptográfica como uma password: não a partilhe por email, chat ou capturas de ecrã.
Se gerar uma chave nova na EuPago, cole-a logo também no Rioko: com a chave antiga, o Rioko recusa os avisos e esses pagamentos ficam por faturar.
Colar a Chave Criptográfica no Rioko
De volta ao Rioko, no passo EuPago.
- 1Cole a chave em 2. Chave Criptográfica.
- 2Se vai criar pedidos de pagamento (passo 07), cole em 3. Chave API do canal (opcional) a Chave API do mesmo canal, que está em Canais → Listagem de Canais na EuPago.
- 3Em Ambiente, escolha Produção. O Teste (sandbox) é só para contas sandbox da EuPago (sandbox.eupago.pt), e nele os documentos ficam em rascunho no InvoiceXpress, no Moloni e no TOConline, e em modo de testes no Vendus.
- 4Carregue em Guardar e continuar.
Ligar o programa de faturação
O passo 2 depende do programa que escolheu. A Ajuda do Rioko mostra onde está cada dado.
- InvoiceXpress
- O nome da conta e a chave API, em Configurações, API.
- Moloni
- Ative a API em Configurações, Configuração da API e Plugins, cole o URL de callback do Rioko em URI de Resposta (Callback), preencha o Developer ID e o Client Secret e carregue em Autorizar o Moloni.
- Vendus
- A chave API, no menu do seu nome, API.
- TOConline
- Peça os Dados API em Empresa > Configurações > Dados API, cole o endereço de redirect do Rioko na página que o TOConline lhe envia, copie os quatro valores para o passo 2 e carregue em Autorizar o TOConline. O guia do TOConline mostra cada passo.
Definições de fatura
Passo 3. A EuPago não diz o IVA da venda: o Rioko usa a taxa que definir aqui.
- Onde emitir
- A empresa e a série no Moloni, a série no InvoiceXpress, a caixa no Vendus; no TOConline, a série predefinida da empresa. Se também fatura por outra origem, use uma série própria: mantém a contabilidade legível e evita problemas de cronologia nas datas.
- Tipo de documento
- Fatura-Recibo por omissão, porque a EuPago só avisa de pagamentos já recebidos. Se preferir fatura e recibo separados, escolha Fatura + recibo automático (no Vendus, o interruptor Recibo automático): a fatura sai no pagamento e o recibo logo a seguir; se a fatura ficar em rascunho, o recibo sai quando a finalizar.
- Taxa de IVA
- A taxa com que cada pagamento é faturado. Vazio = 23%. Com 0%, escolha também o motivo de isenção: sem ele, os pagamentos não são faturados.
- IVA incluído
- Ligado, o valor pago já inclui o IVA.
- Auto Finalizar
- No InvoiceXpress, no Moloni e no TOConline. Ligado, o documento é emitido logo; desligado, fica em rascunho para o finalizar à mão.
No InvoiceXpress, no Moloni e no TOConline, deixe o "Auto Finalizar" desligado nos primeiros pagamentos, para confirmar que está tudo certo, e ligue-o depois.
Ativar e testar
Confirme o primeiro documento antes de deixar a faturação seguir sozinha.
- 1Na mesma página, ative a subscrição da integração (mensal ou anual).
- 2No passo 4, carregue em Marcar como Ativo.
- 3Faça um pagamento de valor baixo no canal EuPago.
- 4Em Últimos documentos aparece o pagamento, com o número da transação EuPago e o estado do documento. Abra o documento no seu programa e confirme totais, IVA e série.
Se deixou o "Auto Finalizar" desligado, ligue-o no passo 3. A partir daí, cada pagamento é faturado automaticamente.
O Rioko fatura-os quando a EuPago o avisa. Se um aviso não chegar, o pagamento fica por faturar, porque o Rioko ainda não consegue ler a lista de pagamentos da EuPago. Compare de vez em quando as transações no backoffice da EuPago com os Últimos documentos. Os pedidos de pagamento (passo 07) não têm este risco: o Rioko confirma-os na EuPago todas as noites.
Faturas com NIF: pedidos de pagamento
Para cobrar a um cliente que precisa de fatura em nome dele, crie o pagamento no Rioko. O Rioko cria-o na EuPago e, quando o cliente paga, a fatura sai no seu programa com o nome e o NIF do cliente. Precisa da Chave API do canal, guardada no passo EuPago (passo 03).
- 1Abra Pedidos de pagamento e carregue em Novo pedido.
- 2Em 1. Cliente, procure o cliente pelo nome, pelo NIF ou pelo email, entre os clientes do seu programa de faturação, ou carregue em + Cliente novo (no TOConline não há pesquisa: carregue em + Cliente novo e indique os dados do cliente). Sem cliente, a fatura sai a «Consumidor final».
- 3Em 2. O que está a cobrar, escreva cada linha: descrição, quantidade, preço e taxa de IVA. Escolha Com IVA ou Sem IVA consoante a forma como escreve os preços. Sem IVA, a fatura sai com esse preço e o cliente paga o total com IVA, que vê no botão Criar pedido.
- 4Em 3. Como o cliente paga, escolha Multibanco (uma referência, entre 1 € e 99 999 €, válida os dias que escolher), MB WAY (o cliente tem 5 minutos para aceitar na app: é para quando está presente) ou Link de pagamento (uma página da EuPago com os meios ativos no seu canal).
- 5Carregue em Criar pedido e envie ao cliente a referência ou o link (Copiar dados).
- 6Quando o cliente paga, o pedido passa a Pago e faturado, com a fatura no seu programa.
No InvoiceXpress e no Moloni, a fatura de um pedido Multibanco sai quando cria o pedido, e o IVA fica devido nessa data, mesmo antes do pagamento. O recibo sai quando o cliente pagar.
Se a referência expirar sem pagamento, o Rioko apaga a fatura se ainda for rascunho. Se já estiver finalizada, o pedido pergunta-lhe se houve entrega: Anular a fatura (não houve entrega) anula-a no seu programa, sem nota de crédito; Manter (houve entrega) deixa-a como dívida do cliente.
Todas as noites o Rioko confirma na EuPago as referências Multibanco e MB WAY por pagar: se um aviso se perder, a fatura sai na mesma.
Os reembolsos fazem-se no backoffice da EuPago. Quando a EuPago avisar, o Rioko emite a nota de crédito sobre a fatura do pedido, se ela já estiver finalizada.
Perguntas frequentes
Que avisos envia a EuPago ao Rioko?
Os Webhooks 2.0 do canal enviam um aviso de Pagamento quando um pagamento é confirmado e um de Reembolso quando é feito um reembolso. O Rioko responde ao primeiro com uma fatura e ao segundo com uma nota de crédito. Os outros tipos de aviso não dão documento.
Preciso da Chave API do canal ou de credenciais da API da EuPago?
Não. O Rioko só precisa da Chave Criptográfica dos Webhooks 2.0: o valor, a data, o meio de pagamento e a referência chegam no próprio aviso, encriptado e assinado.
O que acontece se a Chave Criptográfica estiver errada?
O Rioko recusa o aviso e regista o incidente: nenhum documento é emitido. Cole no Rioko a chave que está no canal EuPago. Os pagamentos recusados entretanto podem ficar por faturar: fale connosco antes de os faturar à mão, para não ficarem com duas faturas.
Posso ter a EuPago e o Shopify em paralelo, no mesmo programa de faturação?
Sim. Cada origem é uma ligação independente, com as suas próprias definições, e ambas podem emitir na mesma conta. Use uma série própria para cada origem: mantém a contabilidade legível e evita problemas de cronologia nas datas.
Porque é que as faturas EuPago saem a «Consumidor final»?
Porque a EuPago não envia o nome, o email nem o NIF de quem paga. Para uma fatura em nome do cliente, com o NIF, crie o pagamento no Rioko, em «Pedidos de pagamento»: a fatura sai com os dados do cliente quando ele paga.
Precisa de ajuda?
Se preferir fazer a configuração connosco, marque uma chamada. Configuramos tudo consigo, em direto.
Marcar uma chamada ↗ calendly.com/pedro-kapta/rioko-support
by