Payouts

Payout é o lado de saída da plataforma: mover dinheiro para onde o seu negócio precisa, no raio certo, com estados claros do início ao fim.

Rails de payout

Rail	Mercado típico	Quando usar
Pix	Brasil	Pagamentos instantâneos 24/7
TED	Brasil	Transferências de maior valor em horário bancário
SPEI	México	Transferência instantânea mexicana
Transferência bancária	Internacional	Conexão bancária direta
Cartão	Internacional	Crédito via rede de cartões
Saque em caixa (cash pickup)	LATAM	Beneficiários sem conta bancária
Interno	Dentro da plataforma	Movimentação entre carteiras próprias

Estado	Significado
pending	Payout criado, aguardando processamento
issued	Instruções emitidas ao banco/provedor
processing	Em trânsito no provedor
realized	Dinheiro creditado ao beneficiário
returned	Devolvido — endereço ou dados inválidos
canceled	Cancelado antes da execução
error	Falha de processamento

POST /api/v1/bank/wallet/payout/

{
  "type": "pix",
  "amount_in_cents": 150000,
  "beneficiary": { "name": "Fornecedor LTDA", "document": "..." }
}