Create QRCode

post

https://sandbox.api.magenpay.io/qrcode/api/v1/external/instant

Create a new instant dynamic Pix QRCode

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Instant dynamic QR Code creation request

amount

number

required

Amount in cents/BRL. The BRL format will become mandatory from February 1st, 2026.

amountFormat

string

Amount format. Accepted "cents" or "brl". We recommend using the BRL format.

amountType

string

enum

Amount type of the BR Code. If the amount type is "custom" the BR Code amount can be changed by the sender at the moment of payment. Options: "fixed" or "custom"

Allowed:

description

string

expirationInSeconds

integer

Time in seconds counted from the creation datetime until the Dynamic BR Code expires. Afterwards, the BR Code cannot be paid anymore. Default value: 86400 (1 day)

keyId

string

required

Receiver's Pix Key id

payerName

string

payerTaxId

string

txId

string

length between 26 and 35

Id to be used for conciliation of the resulting Pix transaction

additionalInfo

array of objects

≤ 50

additionalInfo

Headers

User-Agent

string

required

Client identifier (User-Agent) used for request tracking and security validation.

Responses

Language

Credentials

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201QR Code created successfully

400Invalid request payload

500Internal server error