Saques e transferências
Em Saques, o painel mostra o saldo de cada conta conectada e tira dinheiro dela: para a sua conta bancária ou para uma chave Pix que você salvou. Tudo que sai fica registrado, com a situação de cada envio e um aviso no seu webhook.
Quais contas sacam pela API
| Conta | Para onde | Taxa |
|---|---|---|
| Asaas | chave Pix salva | somada ao valor |
| Stripe | conta bancária cadastrada na Stripe | da Stripe |
| Pagar.me | conta bancária do recebedor principal | sai de dentro do valor |
| Wyvi Pay | chave Pix salva (mínimo R$ 0,30) | somada ao valor |
| Pagmaster | chave Pix salva (R$ 10 a R$ 10.000) | sai de dentro do valor |
| ClownPay | conta cadastrada na ClownPay ou chave Pix salva | somada ao valor |
| InvictusPay | chave Pix salva | somada ao valor |
| TriboPay | conta cadastrada na TriboPay (mínimo R$ 10) | sai de dentro do valor |
| Conta de teste | as duas, com saldo fictício | nenhuma |
Mercado Pago, Efí, Appmax, Woovi, EvoPay, Inter e RivooPay não oferecem saque pela API (ou pedem liberação especial). Saques de subcontas aparecem aqui também. Nelas, o saldo aparece quando a conta informa e o saque é feito no painel delas.
Dica: "conta cadastrada" é a conta bancária ou chave que você validou dentro do provedor. É o destino mais seguro: ninguém consegue mudá-lo pela SuyPay.
O que protege o seu dinheiro
- Chaves salvas. Saques para terceiros só vão para chaves Pix salvas em Saques → Chaves Pix salvas. Só o dono da empresa salva ou remove chaves, e só pelo painel: uma chave de API não cria destinos.
- Espera de 1 hora. Uma chave nova só recebe saques reais 1 hora depois de salva, e todos os seus webhooks recebem
payout_destination.created. Se alguém entrar na sua conta e salvar uma chave, dá tempo de ver e remover. - Limite de 24 horas. A soma dos saques da empresa em 24 horas tem um teto (R$ 5.000,00 até você mudar). Ele é conferido com uma trava: dois pedidos ao mesmo tempo não passam juntos por baixo do limite.
- API desligada por padrão. Saques pela API só funcionam depois que o dono liga em Saques → Segurança. Chaves só cobranças nunca sacam.
- Sem saque em dobro. Cada saque tem uma
Idempotency-Key. Repetir o pedido devolve o mesmo saque. Se a conta não responder (queda, demora), o saque fica Confirmando (uncertain: true) e a SuyPay consulta de novo; ele nunca é reenviado às cegas nem trocado de conta.
Situações
| Situação | Quer dizer |
|---|---|
pending |
registrado, ainda não saiu |
processing |
a conta aceitou e o dinheiro está a caminho |
paid |
chegou |
failed |
a conta recusou ou o banco devolveu; o motivo vem em failure_reason |
canceled |
cancelado antes de sair |