Saltar al contenido principal
POST
Create a Static QR Code

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Account-Id
string<uuid>
requerido

Account ID (UUID format)

Parámetros de consulta

include_base64
boolean
predeterminado:false

Returns the rendered QR code in base64 alongside the EMV payload

Cuerpo

application/json
clientRequestId
string
requerido

Idempotency token that will be echoed by BTG

Minimum string length: 1
Ejemplo:

"8c4ffd09-a264-4779-8d7e-fd24c971d7ff"

receiverKey
string
requerido

Pix key that will receive the payment

Minimum string length: 1
Ejemplo:

"+5511999999999"

amount
string

Fixed payment amount (optional, payer chooses if not provided)

Ejemplo:

"100.00"

description
string

Custom message or description shown to the payer

Ejemplo:

"Payment for order #12345"

merchant
object

Optional merchant metadata overrides

tags
string[]

Custom tags for categorization and correlation

Ejemplo:
txId
string

Transaction identification (txid) to be sent on the payment message

Ejemplo:

"ORDER-12345"

Respuesta

Created

createdAt
string
requerido

Timestamp when the BR Code was created

Ejemplo:

"2024-01-15T10:30:00Z"

emv
string
requerido

QR code payload in EMV format

Ejemplo:

"000201010212..."

id
string
requerido

Unique identifier of the BR Code

Ejemplo:

"550e8400-e29b-41d4-a716-446655440010"

receiverKey
string
requerido

Pix key that will receive the payment

Ejemplo:

"+5511999999999"

amount
string

Fixed payment amount (optional)

Ejemplo:

"100.00"

base64
string

Base64-encoded QR code image (when requested)

Ejemplo:

"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."

description
string

Custom message or description shown to the payer

Ejemplo:

"Payment for order #12345"

merchant
object

Merchant metadata for this BR Code

tags
string[]

Array of custom tags for categorization

Ejemplo:
txId
string

Transaction identification (txid) sent on the payment message

Ejemplo:

"ORDER-12345"