Consultar transferência interna
Veja a situação atual e os detalhes de uma transferência interna, buscando pelo id da PayZu ou pela referência que você mesmo definiu.
Autorização
BearerAuth AutorizaçãoBearer <token>
Em: header
Parâmetros de query
id?string
ID da transação
clientReference?string
Referência externa
Tamanho
length <= 64virtualAccount?string
Subconta virtual (até 50 caracteres) usada na criação. Aceito como chave de busca alternativa.
Tamanho
length <= 50Corpo da resposta
application/json
application/json
application/json
curl --request GET \ --url 'https://api.payzu.processamento.com/v1/internal-transfer' \ --header 'Authorization: Bearer $PAYZU_TOKEN'const url = 'https://api.payzu.processamento.com/v1/internal-transfer';const response = await fetch(url, { method: 'GET', headers: { Authorization: `Bearer ${process.env.PAYZU_TOKEN}`, },});const data = await response.json();console.log(data);import osimport requestsresponse = requests.get( 'https://api.payzu.processamento.com/v1/internal-transfer', headers={ 'Authorization': f'Bearer {os.environ["PAYZU_TOKEN"]}', },)print(response.json()){
"id": "PAYZU20260506T142500ABC123",
"status": "COMPLETED",
"amount": 100.5,
"type": "WITHDRAW",
"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": "513579",
"withdrawPixKey": null,
"withdrawPixType": null,
"receiverName": "Maria Santos",
"receiverDocument": "98765432109",
"receiverInstitutionIspb": "23066240",
"receiverInstitutionName": "PAYZU IP LTDA.",
"receiverAccountNumber": "987654",
"endToEndId": null,
"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
}