Plataforma
Pagamentos: um block com Stripe para receita real
O checkout, as subscrições e os recibos chegam à sua app como código real — com um modo de teste para ensaiar e um modo de produção para quando estiver pronto para cobrar.
O block de Pagamentos do Ciao adiciona pagamentos com Stripe a uma aplicação construída com IA: checkout, subscrições, recibos, e modos de teste e produção separados. Ao contrário de widgets de pagamento incorporados em plataformas fechadas, o block instala-se como código real na sua aplicação, ligado à sua própria conta Stripe — a receita flui para si, e a integração é sua para inspecionar, estender e exportar.
Publicado 2026-07-03 · Última atualização 2026-07-03
O dinheiro é onde os protótipos deixam de ser suficientes
O fosso entre uma app e um negócio é um checkout funcional. É também onde a tolerância a erros cai para zero: cobranças duplicadas, recibos em falta e estados de subscrição avariados custam confiança que um produto jovem não pode dispensar. O código de pagamentos é exatamente a canalização que os fundadores não deveriam construir à mão e as agências não deveriam reconstruir para cada cliente.
O block de Pagamentos adiciona pagamentos com Stripe a uma aplicação Ciao com um clique: checkout, subscrições e recibos, com modos de teste e produção separados. Liga-se à sua própria conta Stripe e instala-se como código real na sua app — inspecionável, extensível e seu.
O que o block inclui
O block cobre a canalização de receita que todo o produto pago precisa.
Checkout
Um fluxo de compra com Stripe ligado à sua aplicação, tratando da parte da transação que nunca quer improvisar.
Subscrições
Planos, testes, upgrades e cancelamentos construídos sobre o modelo de subscrição do Stripe, orientados por regras que descreve em linguagem simples.
Recibos
Os clientes recebem recibos das suas cobranças sem ninguém ter de construir primeiro um pipeline de email.
Modos de teste e produção
Ensaie cada fluxo com cartões de teste do Stripe antes de qualquer cartão real ser cobrado; mude para produção deliberadamente, depois de os gates passarem.
De receita zero à primeira cobrança
O caminho de instalar o block a cobrar um cartão real é deliberadamente controlado por gates.
1. Adicione o block de Pagamentos
Um clique gera fluxos de checkout, tratamento de subscrições e recibos na sua base de código, num branch como qualquer outra alteração.
2. Ligue a sua conta Stripe
A sua conta, os seus clientes, os seus pagamentos. O Ciao liga a integração; a relação comercial é entre si e o Stripe.
3. Descreva o que vende
Produtos, preços e planos em linguagem simples — compras únicas, níveis mensais, testes — e os fluxos são construídos para corresponder.
4. Ensaie em modo de teste
Corra toda a jornada com cartões de teste do Stripe. O QA captura o fluxo de compra como uma repetição determinística, para que fique protegido a partir daí.
5. Passe os gates e vá para produção
Os smoke gates e o painel de segurança para publicação aplicam-se normalmente. Quando tudo estiver verde, mude de teste para produção e receba o primeiro pagamento real.
6. Continue a iterar com segurança
Alterações de preços e novos planos são alterações a uma área protegida — o Guardrails pode exigir revisão sénior para tudo o que toque em fluxos de pagamento.
Porque é que isto importa
Os pagamentos como uma capacidade governada mudam o perfil de risco de lançar funcionalidades de receita. O checkout é coberto por repetições determinísticas de QA, as sondagens de controlo de acesso exercitam as fronteiras à volta dos dados de faturação, e cada alteração perto de dinheiro pode exigir revisão registada. É uma base diferente de um widget largado numa página.
E porque é código real na sua aplicação, os casos limite continuam alcançáveis: um caminho de upgrade personalizado, lógica baseada em lugares, o texto do recibo que a sua equipa financeira pede. Estende código que possui em vez de negociar com um plugin.
Há uma razão pela qual os pagamentos são frequentemente o primeiro block que uma equipa procura: é o teste mais claro de se uma aplicação construída com IA é um produto real. Um checkout que passa repetições determinísticas, um fluxo de subscrição com revisão registada por trás, recibos que chegam sem ninguém se lembrar de os enviar — é isso que significa pronto para produção quando há dinheiro envolvido.
Quem usa o block de Pagamentos
- Fundadores — A primeira versão paga do produto é lançada com o checkout já ensaiado em modo de teste.
- Agências — Os produtos de clientes pagos deixam de exigir uma construção de faturação personalizada por contrato — o block instala-se, a conta Stripe do cliente liga-se.
- Equipas SaaS — Lógica de subscrição com controlo de alterações governado, para que as experiências de preços nunca contornem a revisão.
- Equipas internas e de operações — Marcações, registos e encomendas pagas dentro de ferramentas de outra forma internas, com os recibos tratados.
Notas de segurança e governança
- ✓ Corre na sua própria conta Stripe — os fundos liquidam para si.
- ✓ Os detalhes do cartão são tratados pelo checkout do Stripe, não guardados na base de dados da sua aplicação.
- ✓ Os modos de teste e produção são separados; cada fluxo pode ser ensaiado antes de uma cobrança real.
- ✓ As repetições de QA cobrem as jornadas de compra; os smoke gates correm antes de cada publicação.
- ✓ O Guardrails pode exigir revisão sénior para alterações a fluxos de pagamento.
- ✓ As alterações perto da faturação chegam ao registo de auditoria apenas de acréscimo.
Modo de teste vs modo de produção
Os dois modos existem para que nada na sua primeira cobrança real seja uma surpresa.
| Modo de teste | Modo de produção | |
|---|---|---|
| Cartões | Cartões de teste do Stripe | Cartões reais de clientes |
| Dinheiro | Nenhum fundo se move | As cobranças liquidam para a sua conta Stripe |
| Objetivo | Ensaiar fluxos e correr repetições de QA | Servir clientes |
| Mudança | A predefinição para novas funcionalidades de pagamento | Mudada deliberadamente, depois de os gates passarem |
Perguntas frequentes
Preciso da minha própria conta Stripe?
Sim — o block liga-se à sua conta Stripe, para que os clientes, os pagamentos e as liquidações sejam seus. O Ciao gera e mantém o código de integração dentro da sua aplicação.
Posso personalizar a lógica de checkout e faturação?
Sim. O block é código real na sua app, pelo que pode mudá-lo da mesma forma que muda qualquer outra coisa — descreva o ajuste no Builder, ou aponte para a página de checkout com o inspect-to-prompt. As alterações a fluxos de pagamento passam pelos mesmos gates que tudo o resto.
Como é que as subscrições tratam upgrades e cancelamentos?
São construídas sobre o modelo de subscrição do Stripe, com a sua política descrita em linguagem simples — proporcionar upgrades, cancelar no fim do período, oferecer um teste. Os fluxos resultantes são capturados como repetições de QA para que continuem a funcionar à medida que a app evolui.
É seguro experimentar com funcionalidades de pagamento?
É para isso que a estrutura serve: as alterações acontecem em branches, o modo de teste significa que não há cobranças reais, os smoke gates correm antes de qualquer publicação, e o Guardrails pode exigir revisão sénior para alterações a fluxos de pagamento. A experimentação acontece; as surpresas em produção não têm de acontecer.
Quanto custa o block de Pagamentos?
O block é parte da plataforma; as taxas de processamento do próprio Stripe são entre si e o Stripe. Os criadores individuais começam em self-serve com créditos, e os programas de produção sérios começam em 10.000 USD por ano — veja a página de preços.