Transferir entre contas PayZu
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
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"
}'{
"id": "PAYZU20260506Q8ZR3VN6HT000000",
"status": "COMPLETED",
"amount": 100.5,
"type": "WITHDRAW",
"method": "INTERNAL_TRANSFER",
"qrCodeText": null,
"qrCodeBase64": null,
"qrCodeUrl": null,
"generatedName": null,
"generatedDocument": null,
"generatedEmail": null,
"serviceFeeCharged": 0,
"payerName": "Joao Silva",
"payerDocument": "12345678901",
"payerInstitutionIspb": "23066240",
"payerInstitutionName": "PAYZU IP LTDA.",
"payerAccountNumber": "000000",
"withdrawPixKey": null,
"withdrawPixType": null,
"receiverName": "Maria Santos",
"receiverDocument": "98765432109",
"receiverInstitutionIspb": "23066240",
"receiverInstitutionName": "PAYZU IP LTDA.",
"receiverAccountNumber": "987654",
"endToEndId": "E000000002026050614258kQz2LmN4pX",
"clientReference": "transfer_abc_123",
"createdAt": "2026-05-06T14:25:00.000Z",
"updatedAt": "2026-05-06T14:25:00.123Z",
"paidAt": "2026-05-06T14:25:00.123Z",
"refundEndToEndId": null,
"refundAmount": null,
"refundStatus": null,
"refundReason": null,
"refundDescription": null,
"refundedAt": null,
"cancellationReason": null
}Referência: Transferir para outra conta PayZu
| Campo | Regra |
|---|---|
payerAccountNumber | A sua conta, que precisa ser a do token usado. |
receiverAccountNumber | A conta PayZu de destino. |
amount | Respeita cashOutTicketMin e cashOutTicketMax. A transferência consome o DailyWithdrawLimit da sua conta pelo valor mais a tarifa. |
clientReference | Permite 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ódigo | HTTP | Mensagem |
|---|---|---|
PZC600 | 400 | Não é permitido transferir para a própria conta. |
PZC602 | 400 | O valor mínimo da transferência é R$ 0,01. |
PZC603 | 400 | O valor máximo da transferência é R$ 50.000,00. |
PZC400 | 403 | A conta pagadora não pertence ao solicitante. |
PZC401 | 403 | Transferência interna não habilitada para esta conta. |
PZC200 | 422 | Saldo insuficiente para esta operação. |
PZC201 | 422 | Conta destinatária indisponível. |
PZC202 | 422 | O valor da transferência não cobre a taxa de cash-in do recebedor. |
PZS202 | 422 | Limite diário de saque excedido. |
PZS206 | 422 | Limite diário não configurado para esta conta. |
PZG429 | 429 | Limite 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.