Faturar Pagamentos Stripe no Moloni: Como Funciona
Como cada pagamento da Stripe sai como fatura-recibo no Moloni: plano, artigos, IVA, NIF, total, reembolsos e subscrições, com o que confirmar antes de ligar.

A Stripe cobra e o Moloni fatura, mas um não sabe do outro. A Stripe não é software certificado: as invoices e os receipts que envia não têm ATCUD nem série comunicada à AT. Para cada pagamento ter o seu documento fiscal, alguém tem de o passar para o Moloni, à mão ou por uma integração.
Este guia mostra o que é preciso de cada lado e o que muda no Moloni em relação aos outros programas. As regras gerais, que valem para qualquer programa, estão em Faturar pagamentos Stripe em Portugal.
O que cada lado faz
| Stripe | Moloni | |
|---|---|---|
| Cobrar | Sim: Checkout, Payment Links, subscrições, cobranças pela API | Não |
| Saber quem comprou | Email, nome e, se o pedir no checkout, o NIF | A ficha de cliente |
| Documento fiscal português | Não | Sim: fatura, fatura-recibo, nota de crédito |
| Série e ATCUD | Não | Sim, depois de a série estar registada |
| Devolver dinheiro | Sim: o reembolso | Não: só o documento que o corrige |
A fatura é obrigatória por cada transmissão de bens ou prestação de serviços, e também pelos pagamentos recebidos antes da entrega (artigo 29.º, n.º 1, do CIVA). Quando o pagamento chega antes da entrega ou da prestação, a fatura emite-se na data do recebimento (artigo 36.º, n.º 1, alínea c)).
As três formas de ligar
| Forma | Como funciona | Onde costuma falhar |
|---|---|---|
| À mão | Exportar os pagamentos da Stripe e emitir cada documento no Moloni | Prazo, volume e reembolsos esquecidos |
| Ferramenta genérica de automação | Um gatilho na Stripe cria o documento no Moloni | Subscrições, total ao cêntimo, notas de crédito, isenções |
| Integração dedicada | Lê os eventos da Stripe e emite no Moloni com regras fiscais | Depende de a ligação estar bem configurada |
À mão funciona com poucos pagamentos por mês. Acima disso, o prazo de emissão e os reembolsos são o que primeiro escapa.
O que é preciso no Moloni
- Plano Flex ou superior. A API do Moloni está incluída a partir do plano Flex; o plano Base não a inclui (planos do Moloni).
- Ligação à AT, com um subutilizador. Veja Ligar o Moloni à AT.
- Uma série registada, para os documentos terem ATCUD. Veja Registar séries no Moloni.
- A API ativa, em Configurações, Configuração da API e Plugins. O passo a passo está no guia do Moloni.
Do lado da Stripe, a ligação faz-se com o Stripe Connect, só com leitura: o Rioko lê os pagamentos e os dados de cliente necessários para o documento, e não move dinheiro nem faz reembolsos. Veja o guia da Stripe.
O que muda no Moloni
Um artigo em cada linha
O Moloni exige um artigo da sua conta em cada linha do documento. Há três caminhos, e podem conviver:
- Mapear o produto. Em «Mapear Produtos → Moloni», cada produto da Stripe fica associado a um artigo seu. O artigo mapeado manda na taxa de IVA e no motivo de isenção da linha.
- Mapear pela descrição. Um Payment Link ou uma cobrança pela API muitas vezes não traz produto. Nesse caso, escolhe-se um pedaço do texto que aparece sempre na descrição e o artigo do Moloni que lhe corresponde.
- Deixar o Rioko criar. O que não estiver mapeado fica com um artigo criado pelo Rioko no Moloni, com a taxa que o pagamento trouxer.
Mapear é a forma certa de faturar um catálogo com taxas diferentes. Também é a forma mais rápida de pôr a taxa errada em tudo, se o artigo do Moloni estiver mal configurado: confirme a taxa de cada artigo antes de o mapear.
O IVA de cada linha
Por ordem: a taxa do artigo mapeado; a taxa que vem da Stripe, quando a conta calcula o imposto; a taxa por defeito da ligação, quando o pagamento chega sem imposto. Se a Stripe calcula o IVA com o Stripe Tax, o Rioko verifica ao ativar se a conta o cobra e, se cobrar, lê o IVA da Stripe em todos os pagamentos.
A opção IVA Incluído diz se os preços da Stripe já trazem o imposto. E uma linha a 0 % só sai com um motivo de isenção declarado na ligação ou no artigo: sem ele, o Rioko recusa emitir, em vez de inventar um código.
Quem é o cliente
O NIF chega da Stripe quando o pede no checkout, com a recolha do número fiscal ligada, ou quando o guarda no Customer. Com NIF, o Rioko reaproveita a ficha que já existe no Moloni para esse contribuinte. Sem NIF, o documento sai a consumidor final, com o NIF genérico 999999990.
Um NIF errado corrige-se na ficha do cliente. Um documento já finalizado com o NIF errado não se corrige com nota de crédito: anula-se e emite-se outro. O artigo NIF errado ou pedido depois da compra mostra os dois casos.
O total é o valor pago
Descontos, cupões e arredondamentos fazem a soma das linhas divergir do valor cobrado por cêntimos. O Moloni guarda cinco casas decimais nos preços, e o Rioko acerta o preço unitário para o total bater com o que a pessoa pagou, sem inventar um desconto que ninguém deu.
A data do documento
A do pagamento. Se a série já tiver um documento finalizado com data posterior, o Moloni recusa a data anterior: o documento sai com uma data que a série aceite, e a data do pagamento fica nas observações.
Moeda estrangeira
A fatura sai em euros, à última taxa do BCE publicada no momento do pagamento, com o valor recebido, a moeda e a taxa indicados. O câmbio com que a Stripe converte o que deposita é outro, e é normal não bater ao cêntimo. Mais em Faturar em moeda estrangeira.
Subscrições
Cada fatura da Stripe paga dá um documento no Moloni, com a data do pagamento. Períodos experimentais e faturas a zero não são faturados.
Reembolsos
Cada reembolso, mesmo parcial, dá uma nota de crédito no Moloni, ligada à fatura que corrige, desde que a fatura esteja finalizada. A lei exige que o documento retificativo identifique a fatura a que se refere (artigo 36.º, n.º 6, do CIVA). Se a fatura ainda estiver em rascunho, o Rioko avisa em vez de emitir a nota: um rascunho corrige-se ou apaga-se.
Rascunho ou finalizado
Com o Auto Finalizar desligado, os documentos ficam em rascunho no Moloni até alguém os finalizar. Ligado, saem logo. O email ao comprador sai quando o documento é finalizado, se a opção estiver ligada. O prazo legal de emissão conta da mesma forma: em regra, até ao 5.º dia útil seguinte ao momento em que o imposto é devido (artigo 36.º, n.º 1, alínea a)).
Antes de ligar
- Desligue outra faturação dos mesmos pagamentos, se existir. O mesmo pagamento ficaria com duas faturas.
- Confirme a série onde os documentos vão sair, e que está registada.
- Mapeie os produtos com taxas diferentes de 23 %, ou que sejam isentos.
- Declare a taxa por defeito e o motivo de isenção, se vende sem IVA a algum tipo de cliente.
- Comece com o Auto Finalizar desligado e confira os primeiros documentos com o contabilista: NIF, taxa, isenção, série e total.
A verificação das faturas cabe sempre ao comerciante e ao seu contabilista, antes e depois de automatizar.
Como o Rioko liga a Stripe ao Moloni
O Rioko emite no Moloni cada pagamento da Stripe, incluindo Checkout, Payment Links e renovações de subscrições, e cada reembolso como nota de crédito. Custa 7,50 € + IVA por mês ou 75 € + IVA por ano, por integração.
Veja como funciona com a Stripe → · Preços
Se um pagamento ficar sem fatura, veja o que impede uma fatura de sair.
Fontes
Perguntas frequentes
O Moloni fatura sozinho os pagamentos da Stripe?
Não. A Stripe cobra, mas não emite documentos fiscais portugueses, e o Moloni não sabe que o pagamento existiu. É preciso ligar as duas contas, à mão ou com uma integração.
Que plano do Moloni é preciso para ligar a Stripe?
O plano Flex ou superior, porque a API do Moloni só está incluída a partir daí. A conta tem ainda de estar ligada à AT e ter uma série registada.
Que documento sai no Moloni para cada pagamento?
Uma fatura-recibo, porque o pagamento da Stripe já entrou. Se preferir, a ligação pode emitir fatura.
O Moloni pede um artigo em cada linha. Tenho de criar um por produto?
Não. Em «Mapear Produtos → Moloni» pode associar cada produto da Stripe a um artigo seu, ou mapear pelo texto da descrição. O que não estiver mapeado fica com um artigo criado pelo Rioko.
Que taxa de IVA leva cada linha?
A do artigo do Moloni, quando o produto está mapeado. Sem mapeamento, a do pagamento, quando a Stripe calcula o imposto, ou a taxa por defeito da ligação. Uma linha a 0 % só sai com um motivo de isenção declarado.
E se o comprador não indicar NIF?
O documento sai a consumidor final, com o NIF genérico 999999990. Se o comprador indicar o NIF no checkout da Stripe, o Rioko usa-o e reaproveita a ficha que já existe no Moloni.
O que acontece no Moloni quando reembolso na Stripe?
Cada reembolso, mesmo parcial, dá uma nota de crédito ligada à fatura, desde que a fatura esteja finalizada. O caminho completo está em Do reembolso à nota de crédito.
As renovações das subscrições são faturadas?
Sim. Cada fatura da Stripe paga dá um documento no Moloni, com a data do pagamento. Períodos experimentais e faturas a zero não são faturados.
Recebo em dólares. Como sai a fatura no Moloni?
Em euros, à última taxa do BCE publicada no momento do pagamento, com o valor recebido, a moeda e a taxa indicados no documento.
Posso ver os documentos antes de saírem?
Sim. Com o Auto Finalizar desligado, os documentos ficam em rascunho no Moloni até alguém os finalizar. Veja o que muda entre rascunho e finalizado.
Ficou com dúvidas
Escreva a pergunta. Chega a uma pessoa, não a um formulário.




