Saques e destinos | Kodano Docs

Página em construção

Este é um resumo. O conteúdo completo entra nas próximas versões da documentação; o contrato de cada rota já está na Referência da API.

Cadastre o destino: POST /v1/bank-accounts ou POST /v1/pix-keys. Liste e remova com GET e DELETE.
Uma credencial não tem segundo fator, então o destino cadastrado pela API nasce PENDING_VERIFICATION e só vira VERIFIED quando uma pessoa da loja o confirma no portal Kodano com o código enviado por e-mail.
POST /v1/withdrawals aceita só destination.bankAccountId ou destination.pixKeyId de um destino VERIFIED. Destino pendente responde 422 WITHDRAWAL.DESTINATION_NOT_VERIFIED.
Cada credencial tem um limite diário de saque (padrão de R$ 50.000,00, dia de Brasília), somado ao teto diário da loja. Estouro responde 422 WITHDRAWAL.DAILY_LIMIT_EXCEEDED com remainingAmount e resetAt.
Acompanhe por GET /v1/withdrawals/{id} ou pelos eventos withdrawal.completed e withdrawal.failed.