Consultar cobrança
Acompanhe o status atual e os detalhes de uma cobrança Pix, buscando pelo id, pela sua própria referência ou pelo identificador fim a fim.
Autorização
BearerAuth AutorizaçãoBearer <token>
Em: header
Parâmetros de query
id?string
ID da transação.
clientReference?string
Referência externa fornecida na criação da cobrança.
endToEndId?string
ID end-to-end do Pix.
virtualAccount?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
application/json
curl --request GET \ --url 'https://api.payzu.processamento.com/v1/pix' \ --header 'Authorization: Bearer $PAYZU_TOKEN'const url = 'https://api.payzu.processamento.com/v1/pix';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/pix', headers={ 'Authorization': f'Bearer {os.environ["PAYZU_TOKEN"]}', },)print(response.json()){
"id": "PAYZU20250817215911F49RDOBJ",
"status": "PENDING",
"amount": 10,
"type": "DEPOSIT",
"qrCodeText": "00020126870014br.gov.bcb.pix2565qrcode.payzu.com.br/dynamic/d7790b91-3979-4ad5-9d96-ee941e5a42765204000053039865802BR5908PAYZUPLUS6009SAO PAULO62070503***63047EE4",
"qrCodeBase64": "iVBORw0KGgoAAAANSUhEUgAAAZAAAAGQCAYAAAC...",
"qrCodeUrl": "https://pix.payzu.com.br/v1/pix/qr-code/PAYZU20250817215911F49RDOBJ",
"generatedName": "John Doe",
"generatedDocument": "12345678901",
"generatedEmail": "john.doe@example.com",
"serviceFeeCharged": 0.115,
"payerName": null,
"payerDocument": null,
"payerInstitutionIspb": null,
"payerInstitutionName": null,
"payerAccountNumber": null,
"receiverName": null,
"receiverDocument": null,
"receiverInstitutionIspb": null,
"receiverInstitutionName": null,
"receiverAccountNumber": "513579",
"endToEndId": null,
"createdAt": "2025-08-17T21:59:11.579Z",
"updatedAt": "2025-08-17T21:59:11.579Z",
"paidAt": null,
"withdrawPixKey": null,
"withdrawPixType": null,
"clientReference": "order_12345",
"refundEndToEndId": null,
"refundAmount": null,
"refundStatus": null,
"refundReason": null,
"refundDescription": null,
"refundedAt": null,
"cancellationReason": null
}