Principal Saques e carteira

Saques e carteira

Por Equipe Dotfy •
7 artigos

Qual a diferença entre saldo disponível, a receber e reservado?

Na Dotfy, nem todo valor de uma venda fica pronto para saque ao mesmo tempo. Entender cada parte do saldo ajuda a planejar seus saques. O que cada valor significa - Disponível: o que pode ser sacado para uma chave PIX de mesma titularidade. - A receber ou retido: valores ainda em prazo de liberação, como vendas no cartão. - Reservado: valores separados por causa de uma disputa, como uma MED. Na Carteira, o saldo disponível aparece em destaque, com pendente, retido e total logo abaixo. No Início, o resumo da conta mostra a receber, reservado por MED, retido do cartão (com a data da próxima liberação) e saques em andamento. Quando cada venda entra no saldo? - PIX: na confirmação do pagamento. - Boleto: na compensação, que o banco faz de 1 a 3 dias úteis depois do pagamento. Não há retenção. - Cartão de crédito (Brasil): depois de uma retenção, com padrão de 7 dias, configurável pela Dotfy. Ela existe por risco de chargeback. O aviso de venda diz quanto será creditado e a partir de quando. - Carteira digital: depois de uma retenção de no mínimo 7 dias. - Pagamento internacional: em USDT, na carteira do painel, depois de uma retenção com padrão de três dias, configurável pela Dotfy. Esse valor não entra no saldo em reais. O prazo que vale para você pode variar conforme a sua conta. No cartão e na carteira digital, quando a conta tem reserva configurada, parte do líquido pode ser liberada em uma data posterior. O que acontece em uma disputa? Quando uma MED é aberta, o valor contestado sai do disponível e vai para o reservado. Se você vencer, ele volta para o disponível. Se perder, ele sai em definitivo. Outras retenções A Dotfy pode reter valores por prazo razoável para apuração de fraude, cumprimento de ordem judicial ou determinação regulatória, conforme os Termos de Uso. Para quem integra pela API Em GET /api/balance, o campo available não é exatamente o valor sacável. Ele pode incluir pagamentos com cartão ainda em liberação, que são descontados na hora do saque. Pedir um saque do available inteiro pode voltar como saldo insuficiente. Tem dúvidas sobre um saldo em USDT? Fale com o suporte.

Última atualização em Nov 10, 2026

Como cadastrar e aprovar a chave PIX de saque?

O saque na Dotfy é feito para uma chave PIX cadastrada na sua conta. Só chaves aprovadas podem receber saques. Quais tipos de chave posso usar? CPF, CNPJ, e-mail, telefone ou chave aleatória. Em algumas contas, o saque aceita apenas chave do tipo CPF. A chave precisa estar no meu nome? Sim. O destino do saque deve ser uma chave PIX de mesma titularidade, ou seja, do CPF ou CNPJ do cadastro da conta. A conferência usa o documento do cadastro da conta, não o documento de empresa informado em Configurações. O que preciso antes de cadastrar? A autenticação em dois fatores (2FA) precisa estar configurada na conta. Ela é obrigatória para operações sensíveis, como saques e alteração de chaves PIX. Como a chave é aprovada? A Dotfy confere quem é o titular da chave: - Chave CPF ou CNPJ: é comparada direto com o documento do cadastro. - E-mail, telefone ou chave aleatória: o titular é consultado no diretório oficial do Pix e precisa ser o mesmo documento do cadastro. Quando o titular é exatamente o CPF ou CNPJ do cadastro, a chave já nasce aprovada e pode receber saques. Quando não dá para confirmar o titular, ela segue para análise da equipe. Em contas de pessoa física, chaves de e-mail, telefone ou aleatória costumam ir para análise, porque o CPF normalmente vem mascarado do diretório. Para evitar a análise, prefira a chave do tipo CPF ou CNPJ do seu cadastro. Em subcontas, vale a mesma regra, com o documento cadastrado na subconta. Por que o botão "Continuar" do saque está desabilitado? Sem uma chave válida, o botão fica desabilitado. Só uma chave aprovada pode ficar selecionada. Confira a situação da sua chave ou cadastre outra. Posso remover uma chave? Sim, desde que não exista saque em andamento usando essa chave. Se ela era a padrão, outra chave passa a ser a padrão. Confira qual ficou selecionada antes do próximo saque. Para quem integra pela API As chaves são cadastradas em POST /api/pix-keys. O campo status indica se ela entrou como APPROVED ou PENDING_APPROVAL. Detalhes na Referência da API. Com a chave aprovada, você já pode solicitar o saque na Carteira.

Última atualização em Nov 10, 2026

Como sacar meu saldo, e por que um saque pode ser recusado?

O saldo disponível na Dotfy é transferido por PIX para uma chave aprovada, de mesma titularidade da conta. Passo a passo 1. Confirme que a sua conta tem autenticação em dois fatores (2FA). Ela é obrigatória para saques no painel. 2. Tenha uma chave PIX aprovada, do CPF ou CNPJ do cadastro. 3. Abra a Carteira no painel e vá à área de saque. 4. Informe o valor, escolha a chave e confira a taxa, que é apresentada antes da confirmação. 5. Confirme a operação e acompanhe a situação do saque na Carteira. Quanto é a taxa de saque? Varia conforme a sua conta. Consulte a área de Taxas no painel. A taxa é deduzida automaticamente: sai do saldo o valor pedido, e chega na chave esse valor menos a taxa. Em quanto tempo o dinheiro chega? Pode variar. Saques podem passar por análise de segurança e ter limites diários, e o resultado aparece na situação do saque. Por que o saque foi recusado? As causas mais comuns são: - valor abaixo de R$ 1,00; - valor menor ou igual à taxa; - saldo insuficiente; - saldo disponível abaixo de R$ 4,00; - chave PIX ainda não aprovada; - já existe um saque em andamento, pois a conta aceita um por vez; - limite por saque ou limite diário atingido. Um saque também pode ser recusado ou estornado quando a instituição pagadora não o conclui. Quando o pagamento é recusado em definitivo, o valor bruto é devolvido ao saldo. Lembre que valores de cartão ainda em liberação ou reservados por disputa só ficam disponíveis após o prazo ou a resolução. Posso cancelar um saque? Pela API, um saque que ainda não foi despachado pode ser cancelado com DELETE /api/withdrawals, sem custo: o valor bruto, com a taxa, volta ao saldo disponível. Saque já despachado não volta por esse caminho. Para quem integra pela API - POST /api/withdrawals exige o pixKeyId de uma chave aprovada. - O desfecho chega nos webhooks WITHDRAWAL_COMPLETED ou WITHDRAWAL_FAILED. - Pela API, a chave sozinha autoriza o saque, sem segunda prova. Guarde-a como a senha do banco. - Não existe ambiente de teste para saques: uma chave de teste também movimenta dinheiro real. Veja os detalhes na Referência da API. Se algo não bater com o que você esperava, fale com o suporte e informe o seu ID do cliente.

Última atualização em Nov 10, 2026

Onde vejo meu extrato e os comprovantes de saque?

O painel da Dotfy reúne as movimentações da conta em dois lugares: Transações e Carteira. Onde vejo minhas vendas? Em Transações. No computador, a lista é uma tabela com cliente, data, valor e situação, com abas para cada situação (pendentes, concluídas, expiradas e outras). No celular, as transações aparecem agrupadas por dia, como um extrato bancário. Ao abrir uma transação no celular, o detalhe aparece como um recibo, fácil de ler e de compartilhar. Onde vejo as entradas e saídas do saldo? Na Carteira, na aba de histórico. O Início também mostra as últimas movimentações do saldo, ao lado das últimas vendas. O que aparece no extrato? Sobe o saldo disponível: - crédito de uma venda paga; - split recebido; - comissão. Desce o saldo disponível: - saque; - taxas; - split enviado. Em disputas (MED): - reserva, quando o valor sai do disponível ao abrir a MED; - liberação, quando ele volta porque você venceu; - devolução, quando ele sai em definitivo porque você perdeu. As vendas no cartão aparecem no extrato como qualquer outra venda, depois da liberação. Como consigo o comprovante de um saque? No celular, a Carteira apresenta o comprovante de saque em formato de recibo, junto do histórico de movimentações. Para quem integra pela API - GET /api/balance devolve os saldos em centavos e o extrato paginado. - GET /api/withdrawals lista os saques, do mais recente para o mais antigo. - GET /api/withdrawals/{id} devolve um saque específico, com o rótulo da chave e o nome do titular da conta, o suficiente para montar um comprovante. O nome devolvido em holderName é o do titular da conta que pediu o saque, não o do dono da chave que recebeu. Os valores nessas respostas vêm em centavos. Mais detalhes na Referência da API. Não encontrou uma movimentação? Fale com o suporte e informe o seu ID do cliente.

Última atualização em Nov 10, 2026

O que é o split de vendas e para que serve?

O split divide o líquido de uma venda com outras contas Dotfy no momento em que o dinheiro entra. Não há transferência para fazer depois: quem recebe vê a parte chegar no extrato. Para que serve? Para repartir automaticamente uma venda com parceiros ou afiliados, por exemplo. O destinatário precisa ter uma conta Dotfy ativa e não precisa de nenhuma integração. Em quais vendas funciona? - Funciona: PIX, boleto e cartão de crédito (Brasil). - Não funciona: vendas internacionais liquidadas em USDT e Pix Automático. Como configurar? - Por produto, no painel: na edição do produto, a seção Splits aceita destinatários por e-mail. Toda venda daquele produto no checkout usa essas linhas. - Por cobrança, na API: campo split em POST /api/charges e POST /api/card-charges. Cada cobrança aceita até 10 destinatários, sem repetir nenhum. A divisão pode ser por percentual ou por valor fixo, e a soma dos percentuais não pode passar de 100. Como a parte é calculada? A base é o líquido da venda, ou seja, o valor pago menos a taxa daquele meio de pagamento. Quando a parte é paga? - PIX e boleto: na confirmação do pagamento. - Cartão: na liberação do dinheiro da venda, depois da retenção. E se a parte não for paga? Cada linha é conferida contra o seu saldo livre naquele momento, que é o disponível menos o que ainda está retido de vendas com cartão. Uma linha que não cabe falha, não é reprocessada, e o valor fica com você. O split nunca deixa o seu saldo negativo. Também pode falhar quando o valor calculado é zero ou quando o destinatário está suspenso. Se um e-mail não tiver conta ativa, aquele destinatário é ignorado e a venda acontece normalmente. Divida com quem você confia Para destinatário comum, o split pago é definitivo. Devolução, MED ou chargeback da venda não recuperam a parte dele. Na prática, um split para terceiro é um pagamento feito por você no momento da venda. Como acompanho? A tela de Transações mostra as partes enviadas e recebidas, e o extrato registra cada uma. Quem recebe também pode ser avisado pelo webhook EVENT:SPLIT_RECEIVED. O guia completo está em Split, na documentação.

Última atualização em Nov 10, 2026

O que são subcontas e para quem servem?

Uma conta habilitada como master pode criar subcontas e operar em nome delas. A hierarquia tem exatamente um nível: subconta não cria subconta. Para quem é? Para quem precisa operar recebimentos de outros titulares a partir da própria conta. O recurso depende de habilitação. Se a sua conta ainda não é master, consulte o suporte. O que cada subconta tem? Saldo próprio, taxa própria e verificação de identidade (KYC) própria. A cobrança criada em nome de uma subconta pertence a ela: o dinheiro cai no saldo dela, com a taxa que o master configurou. A subconta entra no painel? Não. A subconta não faz login e não recebe e-mail, push, WhatsApp nem notificação. Quem opera é o master, com a própria credencial, e qualquer comunicação com o titular da subconta é responsabilidade dele. O que pode ser ligado ou desligado? Cada subconta tem três capacidades: receber pagamentos, sacar e gerenciar chaves PIX. Sacar e gerenciar chaves PIX dependem também de o master ter a própria capacidade de saque. A suspensão é diferente: ela congela a subconta inteira. Nada entra e nada sai, nem por split. Como funciona a taxa? O master define a taxa da subconta. O piso é a base do master, e o que passa da base é a comissão dele. Os valores variam conforme a conta. Consulte a aba Taxas ou a API. A taxa de saque segue a mesma regra, com a base de saque. Como a subconta é verificada? Pelo envio de documentos. Contas habilitadas também podem usar a verificação por Pix: o titular paga um Pix de R$ 1,00, válido por 24 horas, a partir de uma conta no CPF ou CNPJ cadastrado. Se o documento de quem pagou conferir, a subconta é aprovada sem análise humana. Documento diferente não reprova a subconta: você pode abrir outra verificação ou enviar os documentos. O valor não é reembolsável. Saques e chaves da subconta Com as capacidades ligadas, o master cadastra chaves PIX e solicita saques em nome da subconta. As chaves seguem a mesma regra de titularidade, com o documento cadastrado nela. Split entre subcontas Duas subcontas do mesmo master podem dividir uma cobrança entre si. O recurso é desligado por padrão, liberado caso a caso, e não existe no cartão. Em uma MED perdida, o valor é cobrado de volta da subconta que recebeu. O guia completo está em Subcontas, na documentação.

Última atualização em Nov 10, 2026