post
https://api.somossimpay.com.br/v2/finance/finance/decode-qrcode
The PIX Decode endpoint lets you submit a full “Copy and Paste” (EMV) QR payload and receive a normalized breakdown of its contents. It identifies the recipient PSP (ISPB), branch/account, account type, PIX key and key type, and—based on the QR kind—returns the appropriate structure for Static, Dynamic (Immediate), Dynamic COBV (with due date), or Compound/Recurring QRs.
Headers
| Parameter | Type | Description | Example |
|---|---|---|---|
| Authorization | String | Bearer + Access_token | Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzEzMzAwOTMxLCJpYXQiOjE3MTMyOTczMzEsImp0aSI6Ijc2ZWI4ZTE5ZjM4YjQ4NmZiODdmNzNjNTdkMWVmNDJhIiwidXNlcl9pZCI6MjQ2fQ.5zekMa7CUj9p-MvNHns5ke4ZPhYV3Y1CLOsYL7hDUUo |
| hmac | String | HMAC (Hash-based Message Authentication Code) is an authentication algorithm that combines a private key with a message to create a Message Authentication Code (MAC). | 57373705c83bc5efe41001790c54642e670088c0c87d56bc8f990f2260c7740b99f4081ff231b87f82118c1e77a959e1f40eacf690a8fa61a827a9ba01d546f6) |
Body Details
{
"pix_copy_and_paste":"00020114br.gov.bcb.pix2566qrcodes.saq.digital/v2/qr/cob/8e1dac81- INSTITUICAO DE PAGAME6009SAO PAULO62070503***630401C8"
}
Response Details
| Parameter | Type | Description | Example |
|---|---|---|---|
| end_to_end_id | String | EndToEndId associated with the QR (when available). | E35535240202509021914WMXBYRRJXL1 |
| type | String | QR type: STATIC, DYNAMIC_IMMEDIATE, DYNAMIC_CHARGE, or COMPOUND. | STATIC |
| journey | String | Operational journey/classification as per PSP/JDPI. | 1 |
| ispb | String | Recipient PSP ISPB (8 digits, zero-padded). | 35535240 |
| agency | String | Recipient bank branch (4 digits, zero-padded). | 0001 |
| account | String | Recipient account number | 000001 |
| account_type | String | Account type. Examples: CHECKING, SAVINGS, PAYMENT, SALARY. | CHECKING |
| key | String | PIX key of the recipient. | +5511975548877 |
| key_type | String | PIX key type: CPF, CNPJ, EMAIL, PHONE, or EVP. | PHONE |
| receiver_name | String | Recipient legal name / company name. | Fulado de tal |
| receiver_fantasy_name | String | Recipient trade name (fantasy name). | Fulano |
| receiver_document_type | String | Recipient document type: CPF or CNPJ. | CPF |
| receiver_document_legal_id | String | Recipient document number, normalized (11/14 digits, zero-padded). | 14481479822 |
| data_qr_code_static | String | Object with static QR details. Present only if type = STATIC. | Object |
| data_qr_code_dynamic_immediate | String | Object with dynamic immediate QR details. Present only if type = DYNAMIC_IMMEDIATE. | Object |
| data_qr_code_dynamic_charge | String | Object with dynamic COBV details. Present only if type = DYNAMIC_CHARGE. | Object |
| data_qr_code_compound | String | Object with compound/recurring QR details. Present only if type = COMPOUND. | Object |
Response QR Code Static
{
"end_to_end_id": "E3553524020250902191000YRRJXL1",
"type": "STATIC",
"journey": null,
"ispb": "00416887",
"agency": "0001",
"account": "123456",
"account_type": "CURRENT",
"key": "bd1e5560-2ff9-4a82-82b8-000000000000",
"key_type": "EVP",
"receiver_name": "Fulano de tal",
"receiver_fantasy_name": null,
"receiver_document_type": "CPF",
"receiver_document_legal_id": "143508877755",
"data_qr_code_static": {
"category_code": null,
"value": 0.03,
"allows_change_value": false,
"city": "City",
"postal_code": null,
"conciliation_id": null,
"additional_data": null,
"ispb_fss": null
},
"data_qr_code_dynamic_immediate": null,
"data_qr_code_dynamic_charge": null,
"data_qr_code_compound": null
}
Response QR Code Dynamic Immediate
{
"end_to_end_id": "E3553524020250902191000YRRJXL1",
"type": "STATIC",
"journey": null,
"ispb": "00416887",
"agency": "0001",
"account": "123456",
"account_type": "CURRENT",
"key": "bd1e5560-2ff9-4a82-82b8-000000000000",
"key_type": "EVP",
"receiver_name": "Fulano de tal",
"receiver_fantasy_name": null,
"receiver_document_type": "CPF",
"receiver_document_legal_id": "143508877755",
"data_qr_code_static": null,
"data_qr_code_dynamic_immediate": {
"end_to_end_id": "E35535240202000000DEF1234567",
"type": "DYNAMIC_IMMEDIATE",
"journey": "ECOMMERCE",
"ispb": "35535240",
"agency": "0001",
"account": "0422297",
"account_type": "PAYMENT",
"key": "f9f1f2c0-2a8d-4f7f-9b3d-00000000077",
"key_type": "EVP",
"receiver_name": "INSTITUIÇÃO DE PAGAMENTO LTDA",
"receiver_document_type": "CNPJ",
"receiver_document_legal_id": "3553520000000",
"data_qr_code_dynamic_immediate": {
"revision": 12,
"conciliation_id": "ABC123456789",
"category_code": "6012",
"receiver_psp_url": "https://psp.exemplo/qr/consulta",
"payer_request": "Pedido #98765",
"payer_name": "JOAO DA SILVA",
"payer_document_type": "CPF",
"payer_document_legal_id": "123451233331",
"city": "SAO PAULO",
"postal_code": "04080922",
"original_value": 100.5,
"allows_change_value": false,
"withdrawal_value": null,
"withdrawal_allows_change_amount": null,
"withdrawal_ispb": null,
"withdrawal_modality_agent": null,
"cashback_value": null,
"cashback_allows_change_amount": null,
"cashback_ispb": null,
"cashback_modality_agent": null,
"expiration": "2025-09-03T12:00:00-03:00",
"additional_data": [
{
"name": "pedido",
"value": "98765"
}
],
"date_time_creation": "2025-09-02T12:00:00-03:00",
"date_time_read": "2025-09-02T12:05:03-03:00",
"reusable": true,
"status": "ACTIVE"
}
},
"data_qr_code_dynamic_charge": null,
"data_qr_code_compound": null
}
Response QR Code Dynamic Charge
{
"end_to_end_id": "E3553524020250902191000YRRJXL1",
"type": "STATIC",
"journey": null,
"ispb": "00416887",
"agency": "0001",
"account": "123456",
"account_type": "CURRENT",
"key": "bd1e5560-2ff9-4a82-82b8-000000000000",
"key_type": "EVP",
"receiver_name": "Fulano de tal",
"receiver_fantasy_name": null,
"receiver_document_type": "CPF",
"receiver_document_legal_id": "143508877755",
"data_qr_code_static": null,
"data_qr_code_dynamic_immediate": null,
"data_qr_code_dynamic_charge": {
"type": "DYNAMIC_CHARGE",
"ispb": "35535240",
"agency": "0001",
"account": "0422297",
"account_type": "PAYMENT",
"key": "[email protected]",
"key_type": "EMAIL",
"receiver_name": "SAQ INSTITUIÇÃO DE PAGAMENTO LTDA",
"receiver_document_type": "CNPJ",
"receiver_document_legal_id": "35535240000000",
"data_qr_code_dynamic_charge": {
"revision": 4,
"conciliation_id": "COBV-2025-000123",
"category_code": "6012",
"receiver_psp_url": "https://psp.exemplo/cobv/consulta",
"receiver_address": "AV. JAMARIS, 100",
"payer_request": "Fatura 2025-09",
"payer_name": "Fulano de tal",
"payer_document_type": "CPF",
"payer_document_legal_id": "1212300456",
"city": "SAO PAULO",
"state": "SP",
"postal_code": "04080922",
"original_value": 150.0,
"abatement": 0.0,
"discount": 10.0,
"fees": 0.0,
"fine": 0.0,
"final_value": 140.0,
"due_date": "2025-10-15",
"days_allowed_pay_after_due": 5,
"additional_data": [
{
"name": "fatura",
"value": "2025-09"
}
],
"date_time_creation": "2025-09-02T12:00:00-03:00",
"date_time_read": "2025-09-02T12:02:45-03:00",
"reusable": true,
"status": "ACTIVE"
}
},
"data_qr_code_compound": null
}
Response QR Code Dynamic Appellant
{
"end_to_end_id": "E3553524020250902191000YRRJXL1",
"type": "STATIC",
"journey": null,
"ispb": "00416887",
"agency": "0001",
"account": "123456",
"account_type": "CURRENT",
"key": "bd1e5560-2ff9-4a82-82b8-000000000000",
"key_type": "EVP",
"receiver_name": "Fulano de tal",
"receiver_fantasy_name": null,
"receiver_document_type": "CPF",
"receiver_document_legal_id": "143508877755",
"data_qr_code_static": null,
"data_qr_code_dynamic_immediate": null,
"data_qr_code_dynamic_charge": null,
"data_qr_code_compound": {
"type": "COMPOUND",
"ispb": "35535240",
"agency": "0001",
"account": "0422297",
"account_type": "PAYMENT",
"key": "f9f1f2c0-2a8d-4f7f-9b3d-2f4c9a6a1c77",
"key_type": "EVP",
"receiver_name": "SAQ INSTITUIÇÃO DE PAGAMENTO LTDA",
"receiver_document_type": "CNPJ",
"receiver_document_legal_id": "355300000000",
"data_qr_code_compound": {
"recurrence_id": "REC-2025-0001",
"frequency": "MONTHLY",
"recurrence_start_date": "2025-09-01",
"recurrence_end_date": "2026-08-31",
"value": 99.9,
"maximum_value": 120.0,
"receiver_ispb": "35535240",
"receiver_document_type": "CNPJ",
"receiver_document_legal_id": "35535240000175",
"receiver_name": "SAQ INSTITUIÇÃO DE PAGAMENTO LTDA",
"receiver_psp_url": "https://psp.exemplo/recurrence",
"payer_name": "Fulano de tal",
"payer_document_type": "CPF",
"payer_document_legal_id": "1234567000001",
"contract_number": "C-2025-009",
"contract_description": "Assinatura mensal",
"retry": 3,
"date_time_read": "2025-09-02T12:00:02-03:00",
"updates": [
{
"status": "ACTIVE",
"date_time_status": "2025-09-02T12:00:02-03:00"
}
]
}
}
}