Saques Pix

Transfira o saldo para qualquer chave Pix.

Criar

Informe o valor, a chave Pix e o tipo. O valor e a tarifa saem de available na hora e ficam em held até o saque terminar. Idempotency-Key é obrigatória.

Em produção, a chave precisa ter sido criada com a opção Permitir saques; sem ela a resposta é 403 key_not_allowed. Chaves de teste sacam sem essa opção.

pixKeyType	Formato de pixKey
`cpf`	11 dígitos
`cnpj`	14 dígitos
`email`	E-mail
`phone`	10 a 14 dígitos, com + opcional
`random`	Chave aleatória, com ou sem hifens

curl -X POST "https://api.sacipix.com/v1/payouts" \
  -H "Authorization: Bearer $GATEWAY_API_KEY" \
  -H "Idempotency-Key: saque-fornecedor-77" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 50000,
    "pixKey": "financeiro@example.com",
    "pixKeyType": "email",
    "reference": "FORNECEDOR-77"
  }'

Em produção, por padrão, todo saque passa por aprovação antes do envio e começa como pending_approval. Assim, uma chave de API vazada não esvazia a conta. Se sua operação exigir saque automático, solicite ao suporte. No sandbox não há aprovação.

Resposta 201

{
  "id": "e4b9a1d6-6f02-4c37-8b15-90d3c7a2f4e8",
  "object": "payout",
  "livemode": true,
  "type": "pix",
  "status": "pending_approval",
  "amount": 50000,
  "fee": 150,
  "currency": "BRL",
  "reference": "FORNECEDOR-77",
  "pix": {
    "key": "financeiro@example.com",
    "keyType": "email",
    "document": null
  },
  "failureReason": null,
  "completedAt": null,
  "createdAt": "2026-11-01T15:04:05.000Z"
}

Ciclo de vida

status	Significado
`pending_approval`	Valor reservado, aguardando aprovação. Pode ser cancelado.
`processing`	Aprovado e em envio.
`paid`	Concluído. `payout.paid` enviado.
`failed`	Não concluído. Reserva devolvida e `payout.failed` enviado.
`rejected`	Rejeitado na análise ou cancelado por você. Reserva devolvida e `payout.failed` enviado.

failureReason traz provider_rejected, crypto_cancelled, manual_resolution ou canceled_by_merchant, ou o motivo escrito pela análise quando o saque é recusado. Baseie a lógica em status.

Cancelar

Só saques em pending_approval podem ser cancelados. Em qualquer outro estado, a API devolve 403 forbidden.

curl -X POST "https://api.sacipix.com/v1/payouts/e4b9a1d6-6f02-4c37-8b15-90d3c7a2f4e8/cancel" \
  -H "Authorization: Bearer $GATEWAY_API_KEY"

Criar

Aprovação

Ciclo de vida

Cancelar