Pesquisar por QR Code Pix dinâmico próprio

Request

ENDPOINT

/baas/qrcode/dynamic

MÉTODO

GET

Path params

Campo	Tipo	Descrição	Caracteres
account_key	string	chave de identificação da QIConta vinculada à chave pix (UUIDv4)	36
pix_key	string	Chave PIX vinculado ao QRCode	-
receiver_conciliation_id	string	Identicação de conciliação do recebedor	max_length = 35
page	integer	Número da página pesquisada (default = 0)	-
page_size	integer	Quantidade de itens por página (default = 15)	-
first_result	boolean	Retornar apenas o primeiro resultado (default = desc)	-
order_by	string	Determina a ordem de retorno dos resultados (default = desc)	asc, desc

info

É obrigatório enviar account_key ou pix_key, sendo apenas um deles obrigatório.

Atenção

Para consultar apenas um QR Code específico, devem ser utilizados os parâmetros receiver_conciliation_id e pix_key.

Response

STATUS

200

Response Body

{
	"pagination": {
		"current_page": 0,
		"next_page": 1,
		"rows_per_page": 15,
		"total_pages": 1,
		"total_rows": 4
	},
	"data": [
		{
			"additional_data": [],
			"amount": 1.0,
			"discounts": [],
			"qr_code_type": "dynamic_term",
			"end_to_end_id": null,
			"base_64": "MDAwMjAxMjY4OTAwMTRici5nb3YuYmNiLnBpeDI1NjdxcmNvZGUtaC5kZXYucWl0ZWNoLmFwcC9iYWNlbi9jb2J2LzQ1NWQ4ZmY1NGE0ZDQ2Mzg4YmVhN2I4MmFhMDZiNzdmNTIwNDAwMDA1MzAzOTg2NTgwMkJSNTkxOVBydVBydXVDb211bmljYWNvZXM2MDA4i2FvUGF1bG82MTA4MDU0MjUwMjA2MjA3MDUwMyoqKjYzMDQyNkNF",
			"expiration_date": "2023-03-30",
			"expiration_seconds": null,
			"max_payment_days": 180,
			"rebate_amount": 0.0,
			"interest_amount": 0.0,
			"fine_amount": 0.0,
			"paid_amount": null,
			"payer_request": null,
			"pix_message": null,
			"modality_alteration": false,
			"payer_name": "Random",
			"payer_document_number": "00000000000000",
			"payer_person_type": "natural",
			"pix_key": {
				"account_key": "ce0db38f-a2ba-446f-bb1a-51d0bf3f40fc",
				"is_activated": true,
				"pix_key": "63602991000100",
				"created_at": "2023-02-14T23:26:52"
			},
			"qr_code_key": "455d8ff5-4a4d-4638-8bea-7b82aa06b77f",
			"qr_code_status": {
				"enumerator": "active"
			},
			"receiver_conciliation_id": "01234567891293134978",
			"created_at": "2023-03-29T15:26:50"
		}
	]
}

STATUS

400

Response Body: Parâmetros Obrigatórios Faltantes

{
    "title": "Bad Request",
    "description": "Must use pix key or account key to search for QR Codes",
    "translation": "Chave Pix ou Chave da Conta devem ser utilizados para realizar buscas por QR Codes",
    "code": "PQR000009"
}

STATUS

400

Response Body: Usuário não possui credenciais

{
    "title": "Unauthorized",
    "description": "User is not allowed to do this transaction",
    "translation": "Usuário não tem autorização para fazer essa transação",
    "code": "PQR000004"
}

STATUS

400

Response Body: Usuário não é dono da conta

{
    "title": "Unauthorized",
    "description": "Person is not account owner.",
    "translation": "A pessoa não é dona da conta.",
    "code": "PQR000005"
}

STATUS

404

Response Body: Chave Pix Não encontrada

{
    "title": "Not Found",
    "description": "No active Pix key found with key \{pix_key\}",
    "translation": "Não foi encontrada pix key ativa com a chave \{pix_key\}",
    "code": "PQR000007"
}

Enumeradores QR Code Status

Enumerador	Descrição
active	QR Code ativo
finished	QR Code pago
written_off	QR Code desativado por solicitação do recebedor/parceiro
bank_written_off	QR Code desativado pela QI