Visão geral de saques e saldo
Como o dinheiro sai da sua conta Accelerazione por Pix, como consultar saldo e extrato, e as diferenças em relação à API de cobranças.
A API de saques transfere dinheiro da sua conta Accelerazione para uma chave Pix. A API de extrato mostra o saldo e as movimentações das contas. Juntas, elas fecham o ciclo: você recebe com cobranças, acompanha o saldo e saca.
Antes de começar
Valores de saque e de extrato seguem a mesma regra das cobranças: inteiros em centavos. 1990 é R$ 19,90 em toda a API.
| Cobranças | Saques | Extrato | |
|---|---|---|---|
| Notificação | Webhook | Não tem; consulte | Não tem; consulte |
| Formato de erro | Problem Details, código em type | Problem Details, código em type | error, message, retryable |
O que você precisa
- Permissões na chave de API:
withdrawalspara saques ebank-accountspara extrato. Peça à equipe de integração. - O
accountIdda sua conta, um UUID entregue no credenciamento. É a conta de onde sai o saque. - A chave Pix de destino cadastrada. Por padrão, o saque só vai para a chave Pix registrada como destino de saque da sua conta.
- Os IPs de saída do seu servidor, se a sua conta usar lista de IPs permitidos nas rotas de saque.
Ambientes
Saques e extrato estão disponíveis somente em produção. O sandbox não expõe essas rotas: uma chamada lá responde 404. Combine com a equipe de integração como homologar o fluxo, normalmente com saques de valor baixo em produção.
Como um saque anda
- Você pede o saque. A API confere o saldo disponível, reserva o valor e responde
201comstatus: "processando". - O saque passa por uma análise. Não há prazo garantido para essa etapa.
- Aprovado, o Pix é enviado à chave de destino e o saque fica
transferido, com o identificador do Pix (pixEndToEndId). - Se o saque for rejeitado, cancelado, expirar ou falhar, o valor reservado volta ao saldo.
Não há webhook de saque. Acompanhe pela consulta.
Nesta seção
Saldo e extrato
Saldo atual, valores agendados e movimentações, com paginação por cursor.
Solicite um saque
Campos, chave Pix de destino, idempotência e regras de valor.
Acompanhe e cancele
Estados do saque, consulta, listagem e cancelamento.
Erros de saque e extrato
Todos os códigos, o que significam e quando repetir.