Principal Pagamentos e Pix

Pagamentos e Pix

Por Equipe Dotfy •
7 artigos

Como funciona uma cobrança PIX?

O PIX é a forma padrão para receber de compradores no Brasil. Ele não depende de liberação extra, ao contrário das demais formas de pagamento. Para criar cobranças, a sua verificação de identidade precisa estar aprovada. Como o comprador paga? Cada cobrança gera um QR Code e um código copia e cola. No checkout, o caminho é este: 1. Abrir o app do banco. 2. Escolher pagar com PIX. 3. Escanear o QR Code ou colar o código. O botão Copiar código PIX ajuda nesse passo. O PIX não exige dado do comprador além do valor. Quanto tempo a cobrança fica válida? A validade é definida na criação da cobrança. Pela API, ela pode ir de 60 segundos a 24 horas. Quando o prazo termina, o checkout mostra PIX expirado e o botão Gerar novo PIX. Para pagar depois disso, é preciso gerar um novo código. Quando o pagamento é confirmado? Em geral, a confirmação chega em segundos. Ela vem pela notificação de pagamento e também por uma verificação automática em segundo plano. Se a notificação atrasar, a confirmação tende a chegar em minutos, não em horas. Depois da confirmação, o comprador vê Pagamento confirmado! e recebe um e-mail com os detalhes da compra. Quando o dinheiro fica disponível? O valor entra no seu saldo em reais na confirmação do pagamento. As taxas são deduzidas automaticamente, conforme a área de Taxas da plataforma. O PIX pode ser devolvido? O PIX não tem chargeback, mas pode ser objeto do MED, o Mecanismo Especial de Devolução do Banco Central. Nesse caso, o valor contestado fica reservado até a conclusão. Veja o artigo sobre MED nesta categoria. Integração Quem usa a API encontra os detalhes no guia Formas de pagamento. Para cobrança recorrente com autorização única, veja o artigo sobre Pix Automático.

Última atualização em Nov 10, 2026

Como funciona o boleto: vencimento e compensação

O boleto atende quem não usa PIX, vendas entre empresas e pagamentos com prazo. Ele é uma forma opcional: precisa estar liberado para a sua conta e, no checkout, ligado no produto. Sem essa liberação, o checkout não mostra a opção. O que o comprador recebe? Um boleto registrado, com linha digitável, vencimento e PDF. Para pagar pelo celular, o caminho no checkout é este: 1. Abrir o app do banco. 2. Escolher pagar boleto ou código de barras. 3. Colar a linha digitável. Quais dados são obrigatórios? O boleto exige o pagador completo: - nome; - e-mail; - CPF ou CNPJ; - endereço. Qual é o vencimento? Pela API, o vencimento pode ser de 1 a 60 dias. O padrão é de 3 dias. Quando o dinheiro entra no saldo? O banco compensa o boleto de 1 a 3 dias úteis depois do pagamento. O valor entra no seu saldo em reais na compensação, sem retenção, porque o boleto não tem chargeback. Por isso, o valor pode não aparecer no saldo logo depois de o comprador pagar. Vale aguardar esse prazo antes de entender que há um problema. Quanto custa? As taxas seguem a tabela da sua conta, na área de Taxas da plataforma. Elas aparecem antes da confirmação de cada operação. Como pedir a liberação? Na seção Pagamentos do produto, cada método mostra o estado dele. Se o boleto aparecer como Ainda não liberado para a sua conta, use o atalho da própria tela para pedir a liberação ao suporte.

Última atualização em Nov 10, 2026

Cartão de crédito: parcelas, retenção e chargeback

O cartão de crédito é uma forma opcional: precisa estar liberado para a sua conta e, no checkout, ligado no produto. Sem essa liberação, o botão de cartão não aparece. Para liberar, fale com o suporte. Como funciona para o comprador? O pagamento é em reais, à vista ou parcelado em até 12x. No checkout, as bandeiras exibidas são Visa, Mastercard, American Express, Elo e Hipercard. Se o cartão for recusado, o comprador pode tentar de novo na mesma página, corrigindo os dados ou usando outro cartão. Cada tentativa é uma cobrança nova. Quais são os valores mínimos? O mínimo é de R$ 10,00 no total e R$ 5,00 por parcela. Cada parcela tem taxa própria, conforme a tabela da sua conta. Se a taxa for maior ou igual ao valor, a cobrança não é criada. Por que o dinheiro fica retido? A retenção existe por causa do risco de chargeback. O valor líquido fica retido por um prazo, com padrão de 7 dias e nunca menos de 1 dia. O prazo é configurável pela Dotfy e pode variar por conta. Só depois disso o líquido entra no seu saldo em reais. O aviso de venda informa quanto será creditado e a partir de quando. O início do painel mostra o total retido do cartão e a próxima liberação. Algumas contas têm reserva rolante. Nesse caso, parte do líquido é liberada em uma data posterior. O que é estorno e chargeback? Um estorno devolve o valor ao comprador. Um chargeback é uma contestação feita pelo comprador junto à instituição emissora do cartão. Ela pode chegar muito depois da entrega. O efeito no seu saldo depende do momento: - Antes da liberação: o crédito é cancelado e nada entra no saldo. - Depois da liberação: a Dotfy recupera o valor, primeiro de valores seus ainda retidos e depois do saldo disponível, sem deixar o saldo negativo. O que não couber é tratado diretamente com você. Veja também o artigo sobre MED e disputas nesta categoria. E a carteira digital? Apple Pay e Google Pay ficam disponíveis só no checkout hospedado. O comprador paga em dólar e você recebe em reais, depois de uma retenção de no mínimo 7 dias. É preciso ter liberação da conta e um produto de preço fixo, na faixa de R$ 10,00 a R$ 100.000,00. Para integrar pela API, consulte o guia de cartão de crédito.

Última atualização em Nov 10, 2026

Como vender para outros países em moeda local?

Com o pagamento internacional, o comprador de outro país paga na moeda dele, por transferência ou por um meio local. É uma forma opcional, liberada por conta e, no checkout, por produto e por país. Quais países e meios estão disponíveis? - Argentina (ARS): transferência bancária. - México (MXN): SPEI e OXXO. - Colômbia (COP): Nequi, Daviplata, Bancolombia, Efecty, Bre-B e transferência. - Equador (USD): transferência e dinheiro. - Venezuela (VES): transferência e Pago Móvil. - Portugal (EUR): MB WAY. Equador, Venezuela e Portugal são liberados um a um pela Dotfy. A Venezuela está sem cotação de câmbio no momento: mesmo liberada, a cobrança não é criada. Um país também pode aparecer como Indisponível no momento. Os meios exibidos podem variar conforme a conta. Como defino o preço? No produto, em Pagamentos, cada país marcado ganha um campo de preço na moeda local. O comprador paga exatamente esse valor. - País sem preço não aparece no checkout. - Peso argentino, peso colombiano e bolívar não usam centavos. - O spread cambial sai do valor que você recebe. Leve isso em conta ao definir os preços. Existe valor mínimo? No México e na Colômbia, contas atendidas pela página de pagamento têm mínimo de USD 5,00. Na Argentina não há mínimo. Cada meio pode ter um mínimo próprio, e a cobrança precisa cobrir a taxa. O que o comprador precisa saber? - Deve usar exatamente o valor indicado. - Na Argentina, a transferência é em pesos, a partir de uma conta com o mesmo CUIT/CUIL informado. - Na Colômbia, é pedido o celular com +57. - Sem pagamento, a cobrança expira cerca de 48 horas depois da criação. No caso argentino, expira pouco depois do prazo informado. Depois de confirmado o pagamento, o comprador recebe a confirmação da compra com o valor que pagou, na moeda dele. Como eu recebo? O valor líquido é creditado em USDT na carteira do painel, no câmbio do momento da compra, descontados o spread cambial e a taxa. Ele não entra no saldo em reais. O crédito acontece depois de uma retenção, com padrão de três dias. O prazo é configurável e pode ser zero. Confirme com o suporte o prazo da sua conta e as opções disponíveis para esse saldo. Para integrar, consulte o guia de vendas internacionais.

Última atualização em Nov 10, 2026

Produtos, links de pagamento e checkout: como funcionam?

Há dois jeitos de cobrar na Dotfy: pelo checkout hospedado, em que a página é da Dotfy e o comprador escolhe a forma de pagamento, e pela API, em que a tela é sua. As formas disponíveis não são iguais nos dois casos: a carteira digital, por exemplo, existe só no checkout. O que é um produto? Cada produto tem um checkout público próprio. O preço pode ser fixo ou definido pelo comprador. No valor definido pelo comprador, o checkout aceita de R$ 1,00 a R$ 100.000,00. Excluir um produto desliga o checkout dele. Produtos com pedidos são preservados. Como escolho as formas de pagamento? Na seção Pagamentos do produto, cada método mostra um estado: - Ligar e desligar: o método está disponível. - Liberado para a conta, indisponível no momento: a liberação existe, mas o método está fora do ar. - Ainda não liberado para a sua conta: há um atalho para pedir a liberação ao suporte. - Indisponível no momento: o método está fora do ar para todas as contas. A linha também indica quando o produto não permite o método, como em alguns casos de valor definido pelo comprador. Toda forma além do PIX é liberada por conta e, no checkout, também por produto. Sem liberação, o checkout não mostra a forma. O que aparece para o comprador? O checkout mostra as formas de pagamento com as respectivas marcas. No editor, em Página > Rodapé, você informa o nome do vendedor responsável, o e-mail e o WhatsApp de contato. Vale preencher: é por ali que o comprador encontra você. Links de pagamento e links de compra são a mesma coisa? Não. - Links de pagamento têm área própria no painel, com atalho no Início, e não aparecem na lista de produtos. - Links de compra são individuais e pertencem a um produto. Eles pré-preenchem os dados de um comprador específico e podem ser revogados. Na API, o webhook de pagamento identifica qual link foi pago. Como recuperar quem não pagou? Os carrinhos abandonados reúnem pedidos criados e não pagos, para ajudar na recuperação de vendas. Para ver as formas de pagamento em detalhe, acesse o guia completo ou entre no painel.

Última atualização em Nov 10, 2026

O que é MED e o que fazer quando uma venda é contestada?

Uma disputa é uma contestação aberta contra uma venda sua. Ela pode ser um MED (Mecanismo Especial de Devolução, do Banco Central, no PIX) ou um chargeback (no cartão). Você não abre nem encerra uma disputa pela plataforma: a abertura e o desfecho chegam de fora. O que você faz é apresentar a defesa. O que acontece com o meu saldo? Enquanto a disputa está aberta, o valor contestado sai do saldo disponível e fica reservado. - Se o resultado for favorável a você, o valor volta para o disponível. - Se for desfavorável, o valor sai em definitivo, porque foi devolvido ao pagador. Uma tarifa por disputa aberta pode ser cobrada, conforme a área de Taxas. Como acompanho? O início do painel mostra o valor reservado por MED e os MEDs aguardando defesa. Os estados de um MED são: aguardando defesa, em análise, favorável, perdida e cancelada. Quem usa a API encontra MEDs e chargebacks na listagem de disputas. Para orientação sobre um chargeback, fale com o suporte. Como faço a minha defesa? Você deve apresentar evidências da entrega do produto ou serviço dentro do prazo indicado na plataforma. No caso de um MED, em geral: 1. Localize o MED na área MEDs do painel. 2. Anexe as evidências. Os tipos são nota, contrato, captura de tela, vídeo, áudio e outros, com até 50 MB por arquivo. 3. Envie a defesa para análise. Dois cuidados importantes: - Subir o arquivo não envia a defesa. Confirme o envio depois de anexar. - A defesa é enviada uma única vez e exige pelo menos uma evidência. Reúna tudo antes de enviar. Depois do envio, a defesa passa por análise antes de seguir para a instituição financeira. O envio não garante um resultado favorável. Que evidências ajudam? Prefira o que mostre a entrega do produto ou serviço, como nota, contrato e capturas de tela. O que serve varia conforme o caso. Disputas podem afetar a minha conta? Sim. Índices de disputa incompatíveis com a atividade, ou contestações fraudulentas contra as próprias vendas, podem levar à suspensão da conta. Com disputas em aberto, também não é possível encerrar a conta. Para consultar as suas disputas agora, entre no painel.

Última atualização em Nov 10, 2026

O que é o Pix Automático e como funcionam as assinaturas?

O Pix Automático é a assinatura do Pix. O seu cliente autoriza uma vez, no app do banco dele, e as parcelas seguintes são debitadas automaticamente na frequência combinada, sem QR Code a cada cobrança e sem cartão. O recurso é liberado por conta. Para habilitar, fale com o suporte. Como o cliente autoriza? Ele lê um QR Code ou abre um link, vê o contrato no app do banco (o nome da sua conta, a descrição, o valor e a frequência) e aprova. Nada é cobrado até essa autorização. Existem duas jornadas: - Autorizar e pagar: o cliente autoriza e paga a primeira parcela no mesmo ato. Serve para planos que começam agora. - Só autorizar: a primeira parcela é debitada em uma data definida. Serve para período de teste ou cobrança que começa em data fixa. Como funcionam as parcelas? O valor mínimo por parcela é de R$ 2,00. Cada parcela paga vira uma cobrança comum, com a mesma taxa da sua conta e o mesmo crédito no saldo de qualquer PIX. E se o débito falhar? Se o débito falhar, por saldo insuficiente, por exemplo, e as retentativas estiverem ligadas, o banco pode tentar de novo até 3 vezes em 7 dias. Esgotadas as tentativas, a parcela é rejeitada e a cobrança dela expira. Entregue o produto só quando a cobrança da parcela estiver paga. Como cancelar? Você pode cancelar a assinatura, e o pagador também pode cancelar pelo banco dele. As parcelas não pagas são canceladas. Parcelas já pagas não são estornadas. Tem alguma limitação? Sim: o Pix Automático não aceita split. Para os detalhes técnicos, consulte o guia de Pix Automático.

Última atualização em Nov 10, 2026