PayZu PixPagar com Pix

Transferir entre contas PayZu


Nesta páginaFaça a transferênciaConfirme a transferênciaErros desta operação

Transfira saldo para outra conta PayZu pelo número dela e receba o resultado final na própria resposta da chamada.

Faça a transferência

bash
curl -X POST https://pix.sandbox.payzu.dev/v1/internal-transfer \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "payerAccountNumber": "000000",
    "receiverAccountNumber": "987654",
    "amount": 100.5,
    "description": "Pagamento referente a fatura #1234",
    "callbackUrl": "https://webhook.cool/",
    "clientReference": "transfer_abc_123"
  }'

Referência: Transferir para outra conta PayZu

CampoRegra
payerAccountNumberA sua conta, que precisa ser a do token usado.
receiverAccountNumberA conta PayZu de destino.
amountRespeita cashOutTicketMin e cashOutTicketMax. A transferência consome o DailyWithdrawLimit da sua conta pelo valor mais a tarifa.
clientReferencePermite repetir a chamada sem duplicar a transferência.

Na resposta, serviceFeeCharged traz a sua tarifa e method vem INTERNAL_TRANSFER.

Repetir o clientReference com o mesmo valor e as mesmas contas retorna a transferência já feita.

Com valor ou conta diferentes, a PayZu recusa com 409.

Confirme a transferência

Se a chamada respondeu 200, a PayZu já criou um WITHDRAW na sua conta e um DEPOSIT na conta de destino, com o débito e o crédito feitos.

A PayZu ainda chama a callbackUrl informada e dispara TRANSACTION_COMPLETED nos webhooks das duas contas, o que avisa o recebedor de que o crédito entrou. O corpo está em Transação concluída.

Em timeout, repita a chamada com o mesmo clientReference: você recebe a transferência existente ou uma nova. Para conferir antes, veja Consultar uma transferência.

Erros desta operação

CódigoHTTPMensagem
PZC600400Não é permitido transferir para a própria conta.
PZC602400O valor mínimo da transferência é R$ 0,01.
PZC603400O valor máximo da transferência é R$ 50.000,00.
PZC400403A conta pagadora não pertence ao solicitante.
PZC401403Transferência interna não habilitada para esta conta.
PZC200422Saldo insuficiente para esta operação.
PZC201422Conta destinatária indisponível.
PZC202422O valor da transferência não cobre a taxa de cash-in do recebedor.
PZS202422Limite diário de saque excedido.
PZS206422Limite diário não configurado para esta conta.
PZG429429Limite de requisições atingido. Tente novamente em breve.

Os códigos de autenticação e de validação estão no Catálogo de erros.