Pular para o conteúdo principal

Saques (payouts)

Envie dinheiro para fora da sua carteira PagNow via PIX, TED ou cripto.

Criar um saque​

POST /v1/withdrawals

curl -X POST 'https://v2.pagnow.com/v1/withdrawals' \
  -H 'apikey: pnk_sua_chave_aqui' \
  -H 'content-type: application/json' \
  -d '{
    "type": "PIX",
    "amount": 10000,
    "currency": "BRL",
    "pixKey": "maria@exemplo.com",
    "pixKeyType": "EMAIL"
  }'

amount é em centavos. Para cripto, envie type: "CRYPTO" com cryptoAddress, cryptoNetwork e cryptoCurrency.

Aprovação automática vs manual​

Todo saque começa em PENDING. Se ele é despachado na hora ou fica aguardando aprovação manual depende da configuração de saque automático da sua conta:

  • Saque automático ativado — o saque é aprovado e enviado imediatamente.
  • Saque automático desativado (padrão) — o saque fica PENDING até a PagNow aprovar.

Fale com seu gerente de conta para ativar o saque automático.

Consultar e listar​

# Um saque específico
curl 'https://v2.pagnow.com/v1/withdrawals/{id}' \
  -H 'apikey: pnk_sua_chave_aqui'

# Listar (mais recentes primeiro); filtra por status
curl 'https://v2.pagnow.com/v1/withdrawals?status=PENDING' \
  -H 'apikey: pnk_sua_chave_aqui'

Acompanhar o resultado​

O ciclo de vida (PENDING → APPROVED → PROCESSING → COMPLETED/FAILED) chega pelos eventos de webhook withdrawal.*. Um saque que falha após o débito tem o valor estornado para a carteira automaticamente.