Create a Static QR Code

Use this endpoint to create a static Pix BR Code that can be reused for multiple payments.

Notes:

• Static QR Codes are reusable and can be paid multiple times
• Amount is optional - if not provided, the payer will enter the amount
• The receiver key must be owned by the account holder making the request
• The QR Code payload (EMV) is generated following the EMV QCO specification

POST /v1/brcode/static

Create a Static QR Code

cURL

curl --request POST \
  --url https://api.example.com/v1/brcode/static \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-Account-Id: <x-account-id>' \
  --data '
{
  "clientRequestId": "8c4ffd09-a264-4779-8d7e-fd24c971d7ff",
  "receiverKey": "[phone]",
  "amount": "100.00",
  "description": "Payment for order #12345",
  "merchant": {
    "categoryCode": "5411",
    "city": "São Paulo",
    "name": "Loja ABC",
    "postalCode": "01310000"
  },
  "tags": [
    "checkout",
    "web"
  ],
  "txId": "ORDER-12345"
}
'

201

{
  "createdAt": "2024-01-15T10:30:00Z",
  "emv": "000201010212...",
  "id": "550e8400-e29b-41d4-a716-446655440010",
  "receiverKey": "[phone]",
  "amount": "100.00",
  "base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
  "description": "Payment for order #12345",
  "merchant": {
    "categoryCode": "5411",
    "city": "São Paulo",
    "name": "Loja ABC",
    "postalCode": "01310000"
  },
  "tags": [
    "checkout",
    "web"
  ],
  "txId": "ORDER-12345"
}

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:

"[phone]"

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

Show child attributes

tags · string[]

Custom tags for categorization and correlation

Ejemplo:

["checkout", "web"]

txId · string

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

Ejemplo:

"ORDER-12345"

Respuesta

201

application/json

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:

"[phone]"

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

Show child attributes

tags · string[]

Array of custom tags for categorization

Ejemplo:

["checkout", "web"]

txId · string

Transaction identification (txid) sent on the payment message

Ejemplo:

"ORDER-12345"