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

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

Response

end_to_end_id
string
End to end ID - can be used for 30d after generation.
credit_party
object
Beneficiary data.
amount
number
Amount of the QR code.
is_amount_changeable
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