Skip to main content
POST
Decode QR Code

Decode QR Code

Decode third-parties PIX QR codes to make them payable at the create payment endpoint.

Request Body

string
required
EMV from the QR Code.Example: 00020126580014BR.GOV.BCB.PIX...
string
Data of payment - optional parameter, should be used with QR Codes that have discount or fines.Format: <date>
string
City code.

Response

string
End to end ID - can be used for 30d after generation.
object
Beneficiary data.
number
Amount of the QR code.
boolean
If true, the amount can be changed at payment endpoint.

Request Example

Use Cases

Decode and pay a PIX QR Code from another institution:
Validate QR Code and show details to user before confirming:
Handle QR Codes where amount can be changed:
Process multiple QR Codes in batch:

Best Practices

End-to-End ID Validity: The end_to_end_id can be used for 30 days after generation. Store it if you need to make the payment later.
Amount Validation: Always check is_amount_changeable before allowing users to modify the payment amount.
Error Handling: Implement proper error handling for invalid QR Codes. Not all QR Codes are valid PIX codes.
QR Code Format: The EMV string should be the complete PIX QR Code string starting with “00020126…”.

PIX Key Types

Common PIX key types you might encounter:

Integration Flow

Create Payment

Create payment after decoding QR Code

Callback Payment

Receive payment notifications