Pagamentos

Vender pelo site é mais
do que colocar um botão.

Quando dinheiro entra pelo site, a estrutura precisa dar conta de pedido, evento, entrega, reembolso, contestação e conciliação. A Viceja constrói essa camada — com o recebimento sempre na sua conta.

Como trabalhamos

Seis princípios que não são negociáveis.

São eles que separam uma operação que parece funcionar de uma operação em que você pode confiar no relatório.

Princípios de integração de pagamentos

01

O dinheiro é seu, na sua conta

Cada cliente abre e mantém a conta no provedor em seu próprio CNPJ ou CPF. A Viceja integra usando credenciais protegidas no back-end, mas não recebe o dinheiro dos seus compradores, não mistura receitas e não desconta a própria remuneração das suas vendas.

02

A página de sucesso não confirma nada

Confirmação real vem do status do provedor e do evento recebido no back-end — nunca do fato de o navegador ter voltado para uma URL. Produto, acesso ou serviço só são liberados a partir do estado confirmado.

03

Webhook precisa ser idempotente

Um evento pode chegar mais de uma vez, fora de ordem ou depois de uma falha. O endpoint valida a assinatura, verifica se já processou aquele identificador, persiste o evento, responde rápido e processa de forma assíncrona.

04

Venda, pagamento, recebimento e repasse são coisas diferentes

Misturar esses conceitos produz relatório errado. Uma venda parcelada pode estar paga pelo comprador e ser recebida em datas futuras. Um Pix pode ser aprovado rápido e ainda exigir reconciliação com o extrato.

05

Nunca guardamos dados de cartão

Usamos checkout hospedado, tokenização ou os componentes oficiais do provedor. Número completo de cartão, código de segurança e dados equivalentes não são armazenados no banco do projeto.

06

A conciliação mostra as diferenças

Se o sistema, o painel do provedor e o extrato bancário não batem, o relatório mostra a divergência em vez de escondê-la para o painel parecer conciliado.

O fluxo de uma venda

Oito momentos — e um responsável para cada um.

Dividir a venda em momentos evita que o site e o controle financeiro dependam apenas de uma página de sucesso.

Fluxo completo de uma venda

  1. 1. Oferta

    Exibir produto, serviço, preço, condições e política de compra.

    Cliente
  2. 2. Checkout

    Criar sessão, preferência ou cobrança no provedor.

    Viceja
  3. 3. Pagamento

    Provedor processa Pix, boleto ou cartão.

    Provedor
  4. 4. Webhook

    Receber, validar, persistir e normalizar o evento.

    Viceja
  5. 5. Pedido

    Atualizar status do pedido e liberar a próxima ação.

    Viceja
  6. 6. Entrega

    Liberar material, agenda, acesso ou instrução de atendimento.

    Cliente e Viceja
  7. 7. Recebimento

    Provedor libera o valor na conta do cliente.

    Provedor e cliente
  8. 8. Conciliação

    Comparar venda, taxa, saldo líquido, repasse e extrato.

    Viceja e contador

Provedores

Não existe um provedor melhor para todo mundo.

A recomendação é orientada pelo tipo de operação — e o contrato deixa claro que você escolhe ou aprova o provedor, mantém a titularidade da conta e arca com as taxas e políticas dele.

Comparativo de provedores de pagamento

Integração padrão recomendada

Asaas

Melhor uso: Pequenos negócios brasileiros, serviços, produtos digitais, Pix, boleto e recorrência.

Pontos fortes: API, checkout, Pix, boleto, cartão, cobrança recorrente, webhooks, sandbox e recursos de gestão.

Cuidados: Taxas e condições variam por conta; validar antecipação, parcelamento e limites.

Alternativa para implantação rápida

Mercado Pago

Melhor uso: Lançamento rápido, checkout hospedado e público brasileiro familiarizado com a marca.

Pontos fortes: Checkout Pro, Checkout Transparente e Bricks; Pix, boleto, cartão e webhooks com assinatura secreta.

Cuidados: O checkout hospedado pode tirar o comprador do site; conferir tarifas e regras de liberação.

Assinaturas sofisticadas e operação internacional

Stripe

Melhor uso: SaaS, produtos com ciclo de vida complexo e cobrança fora do Brasil.

Pontos fortes: Checkout, Billing, assinaturas, webhooks, antifraude e documentação ampla.

Cuidados: Disponibilidade e custo do Pix precisam ser confirmados antes de prometê-lo como padrão.

Volume maior e casos de plataforma

Pagar.me

Melhor uso: Operações com integração avançada e casos que podem demandar split.

Pontos fortes: Pix via API, webhooks, estorno e split conforme documentação.

Cuidados: Exige avaliação comercial e técnica; não deve ser escolhido só pela taxa anunciada.

Taxas, prazos de liberação, antecipação, parcelamento e disponibilidade de meios variam por conta e por contrato. Confirme as condições com o provedor antes de prometer qualquer meio de pagamento na sua página de oferta.

Responsabilidades

Quem responde por quê.

Papéis claros evitam a pior conversa possível: a que acontece depois que algo deu errado.

Matriz de responsabilidades

AtividadeVocêVicejaProvedor
Definir oferta e preçoResponsávelConsultadaInformado
Abrir conta de pagamentoResponsávelConsultadaExecuta
Integrar checkoutConsultadoResponsávelConsultado
Processar pagamentoInformadoInformadaResponsável
Confirmar evento técnicoInformadoResponsávelConsultado
Entregar produto ou serviçoResponsávelConsultadaInformado
Aprovar reembolsoResponsávelConsultadaExecuta
Emitir documento fiscalResponsávelApoio técnicoInformado
Conciliar painel e sistemaConsultadoResponsávelConsultado

A definição da natureza fiscal da venda, a emissão de documento fiscal e a apuração continuam com você e com o seu contador. Veja também a política de privacidade.

Perguntas frequentes sobre pagamentos

A Viceja recebe o dinheiro das minhas vendas?

Não. Você recebe diretamente na sua conta do provedor, aberta no seu nome. A Viceja cobra apenas a própria ativação e o próprio Engine, por cobrança separada. Essa separação reduz risco operacional e evita que a Viceja seja tratada como recebedora ou intermediadora financeira.

Quem paga as taxas do meio de pagamento?

Você, como custo de venda. As taxas pertencem à relação entre você e o provedor e não são absorvidas na mensalidade da Viceja. Nós ajudamos a configurar e a monitorar o fluxo, e registramos a taxa efetiva informada pelo provedor no relatório de conciliação.

Qual provedor vocês recomendam?

Para a maior parte dos negócios brasileiros, Asaas como integração padrão — ele combina Pix, boleto, cartão, recorrência, checkout e webhooks em uma operação direta. Mercado Pago é o caminho para implantação rápida com checkout conhecido, e Stripe entra quando a assinatura ou a operação internacional justificam. A escolha final é sua e consta em contrato.

Vocês emitem minhas notas fiscais?

Não. A natureza fiscal da venda e a emissão de NF-e ou NFS-e são responsabilidade sua e do seu contador. A Viceja pode configurar campos e integração conforme o escopo contratado, e guardar a referência do documento — mas integração fiscal é um módulo separado, aprovado pelo seu contador.

O que acontece em um chargeback?

Você responde pela política comercial, pela entrega e pelo relacionamento com o comprador. A Viceja fornece a interface e o fluxo técnico, registra quem autorizou cada ação e atualiza pedido, acesso e relatório. A entrega pode ser congelada conforme o previsto em contrato.

Dá para fazer split de pagamento entre vários vendedores?

Isso é a faixa Platform, e não é recomendada para o começo. Split não é só um botão: exige revisão de contrato, responsabilidade por chargebacks, cadastro e verificação de recebedores, titularidade do dinheiro, emissão fiscal e proteção de dados. Só deve ser lançado após validação jurídica, contábil e comercial específica.

Commerce e Recurring

Antes de vender pelo site, vale saber o que precisa existir por trás.

Conte o que você vende, para quem, com qual ticket e se haverá recorrência. A partir daí definimos a faixa e a arquitetura de pagamento certa.

Você não precisa chegar com tudo pronto. Basta ter uma presença, uma oferta ou uma oportunidade que merece ser desenvolvida.