Ir para o conteúdo
P Prontopag API PixPáginas

Criar saque

Envia um Pix do seu saldo para a chave do favorecido. O idEnvio é seu, e repetir o mesmo idEnvio com o mesmo corpo devolve o mesmo saque.

PUT /v2/ex/pix/{idEnvio}

Escopo: ex.pix.send.

PUT /v2/ex/pix/SAQ01J1ZK7M9QW3ERT5TY6UI8O
{
  "tipo": "SAQUE",
  "valor": "300.00",
  "solicitadoEm": "2026-09-18T12:00:00Z",
  "favorecido": { "chave": "fulano@exemplo.com", "cpf": "12345678909" },
  "referenciaExterna": "saque-778812",
  "infoPagador": "Saque pedido 778812"
}
→ 201
{
  "idEnvio": "SAQ01J1ZK7M9QW3ERT5TY6UI8O",
  "endToEndId": "E12345678202609181200000000000003",
  "status": "EM_PROCESSAMENTO",
  "tipo": "SAQUE",
  "valor": "300.00",
  "solicitadoEm": "2026-09-18T12:00:00Z",
  "prazoRegulatorio": "2026-09-18T14:00:00Z",
  "favorecido": { "chave": "fulano@exemplo.com", "cpf": "12345678909" },
  "referenciaExterna": "saque-778812",
  "infoPagador": "Saque pedido 778812",
  "sla": { "estouradoNaEntrada": false, "restanteSegundos": 7199 }
}

Campos do request #

Campo Tipo Obrigatório Descrição
tipo string sim SAQUE ou PREMIO.
valor string sim Valor com duas casas.
solicitadoEm string sim Instante em que o seu cliente pediu, RFC 3339.
favorecido.chave string sim Chave Pix do favorecido.
favorecido.cpf string sim CPF do favorecido. Tem de ser o dono da chave.
referenciaExterna string não O seu identificador, devolvido nas consultas.
infoPagador string não Texto que vai no comprovante do favorecido.
idEnvioOriginal string não Para repetir um saque NAO_REALIZADO por motivo corrigível.
subconta string não Id da sub-conta que paga. Omitido, paga a conta principal.

Campos do response #

Campo Tipo Descrição
status string EM_PROCESSAMENTO, depois REALIZADO ou NAO_REALIZADO.
endToEndId string Identificador do Pix. Pode mudar uma vez quando o custodiante é PARCEIRA; chaveie pelo idEnvio.
prazoRegulatorio string solicitadoEm mais 120 minutos.
sla.restanteSegundos inteiro Quanto falta para o prazo.

O desfecho chega pelo webhook payout.realizado ou payout.nao_realizado. Depois de um timeout ou 5xx, consulte GET /v2/ex/pix/{idEnvio} antes de repetir; se responder 404, repita o PUT com o mesmo idEnvio.

Erros #

Status title Quando
400 id_envio_invalido idEnvio fora de 26 a 35 caracteres alfanuméricos.
400 chave_nao_pertence_ao_documento O dono da chave no diretório não é favorecido.cpf.
400 favorecido_pj_nao_permitido A chave é de pessoa jurídica.
400 solicitado_em_invalido solicitadoEm fora do formato ou fora da janela.
403 subconta_indisponivel subconta existe e não está ATIVA.
409 id_envio_duplicado O mesmo idEnvio já existe com outro corpo.
422 subconta_nao_encontrada subconta não existe.
422 saldo_insuficiente O disponível não cobre o valor.
422 saldo_bloqueado_med Há saldo, mas está retido por uma contestação.
422 limite_excedido Acima do teto por transação ou do teto diário do CPF. Os números vêm em violacoes.
422 chave_sob_reivindicacao A chave está em portabilidade ou reivindicação. Peça outra.
422 favorecido_restrito O CPF do favorecido está restrito.
422 pagamento_negado_compliance Recusa da análise de risco. Não repita.
422 cadeia_retry_invalida idEnvioOriginal não aponta para um saque NAO_REALIZADO com o mesmo tipo e solicitadoEm.