Create Decoded QR Code
GET/pix/payments/decode
Generate a new Decoded QR Code ID to facilitate pix payments by QR code. Provide the QR Code's information in the request body and execute to obtain its ID (decoded_qr_code_id), which is required for creating pix payments using a QR Code.
Request
Query Parameters
QR Emv code.
Payment estimated date.
Header Parameters
The transaction ID is a UUID (v4) used to uniquely identify the object that will be created. All objects must have an identifier.
The nonce ID is a UUID (v4) used to uniquely identify the requisition. All requisitions must have an identifier.
Possible values: [pt-BR
, en-US
]
Indicates the preferred language. Defaults to Brazilian Portuguese if unspecified.
Responses
- 200
- 400
- 401
- 422
QR code decoded successfully.
- application/json
- Schema
- Example (from schema)
Schema
Unique decoded UUID.
Payment link's key.
Payment txid identifier.
Document value.
Recipient name.
Possible values: [NATURAL_PERSON
, LEGAL_PERSON
]
Recipient person type.
Recipient document.
Payment value.
Expiration date.
Possible values: [NATURAL_PERSON
, LEGAL_PERSON
]
Payer person type value.
Payer document.
Payer name.
Due date.
Interest value.
Fine value.
Deduction value.
Discount value.
Possible values: [ERROR
, PENDING
, READY
, CANCELED
]
QR code state.
Created at.
Change value.
Additional infos object.
Additional info.
Possible values: [QR_CODE_STATIC_INSTANT_PAYMENT
, QR_CODE_STATIC_WITHDRAWAL
, QR_CODE_DYNAMIC_DUE_DATE
, QR_CODE_DYNAMIC_WITHDRAWAL
, QR_CODE_DYNAMIC_CHANGE
, QR_CODE_DYNAMIC_INSTANT_PAYMENT
]
QR code type.
Possible values: [ACCOUNT
, KEY
, QR_CODE
, QR_CODE_STATIC_INSTANT
, QR_CODE_STATIC_WITHDRAWAL
, QR_CODE_DYNAMIC_DUE_DATE
, QR_CODE_DYNAMIC_WITHDRAWAL
, QR_CODE_DYNAMIC_CHANGE
, QR_CODE_DYNAMIC_INSTANT
]
Payment Type.
Is value updating allowed?
Withdrawal value.
{
"id": "d5e0bec8-8695-4557-b0dd-021788cd83ef",
"key": "string",
"txid": "string",
"document_value": 1299,
"recipient_name": "string",
"recipient_person_type": "LEGAL_PERSON",
"recipient_document": "***456789**",
"payment_value": 1299,
"expiration_date": "2025-02-01T15:42:01.479Z",
"payer_person_type": "LEGAL_PERSON",
"payer_document": "***456789**",
"payer_name": "string",
"due_date": "2025-02-01T15:42:01.479Z",
"interest_value": 1299,
"fine_value": 1299,
"deduction_value": 1299,
"discount_value": 1299,
"state": "PENDING",
"created_at": "2025-02-01T15:42:01.479Z",
"change_value": 1299,
"additional_infos": [
{
"name": "Juros",
"value": "10%"
}
],
"additional_info": "string",
"type": "QR_CODE_STATIC_WITHDRAWAL",
"payment_type": "QR_CODE",
"allow_update": true,
"withdraw_value": 1299
}
If any required params are missing or has invalid format or type.
User authentication failed.
If any required params are missing or has invalid format or type.