Generate Static QR Code

Creates a static QR Code for receiving payments via Pix. Static QR Codes contain the payment information directly in the EMV payload (BR Code). Requires Idempotency-Key header.

Headers

Idempotency-Key
Type: string
required

Unique idempotency key to prevent duplicate charge creation

Body·

required

application/json

Request to create a static QR Code for Pix payments

key
Type: string
min length:
1
required

Pix key of the receiver. EVP, email, CPF/CNPJ or phone in E.164 format (+55...).
merchant
Type: object ·
required

Merchant (receiver) information for EMV payload composition
additionalInfo
Type: string

Optional additional information for the payer (1..72).
cashierBankCode
Type: string

Optional. ISPB (8 digits) of the FSS (Facilitador de Serviço de Saque) when the QR Code is used for Pix Saque or Pix Troco. Omit for regular Pix charges.
emitImage
Type: boolean

If true, also returns the PNG image (base64).
txid
Type: string

Transaction identifier (EMV 62-05) [A-Za-z0-9], 1..25. If absent, fin-charge-api generates it.
value
Type: string

Optional. Value in decimal format with exactly 2 decimal places (e.g., '123.98' for R$ 123,98). Must be a string, not a number. Omit for charges where the payer chooses the amount (e.g., Pix Saque/Troco, donations, open-amount QR codes).

Responses

application/json

Código interno	HTTP	Descrição	Erro normativo Bacen
`CHARGE-0006`	400	Failed to generate QR image	—
`CHARGE-0007`	400	QR payload must not be blank	—
`CHARGE-0008`	400	Amount must be greater than or equal to 0	`CobOperacaoInvalida`

application/json

application/json

Código interno	HTTP	Descrição	Erro normativo Bacen
`CHARGE-0001`	404	Invalid Pix key: key not found or inactive	`CobOperacaoInvalida`

application/json

application/json
application/json
application/json

Código interno	HTTP	Descrição	Erro normativo Bacen
`CHARGE-0003`	409	Charge with txid already exists	`CobOperacaoInvalida`

Código interno	HTTP	Descrição	Erro normativo Bacen
`CHARGE-0005`	502	Error validating Pix key	`ServicoIndisponivel`

post/api/v1/charges/static

curl http://localhost/api/v1/charges/static \
  --request POST \
  --header 'Idempotency-Key: 550e8400-e29b-41d4-a716-446655440000' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "key": "",
  "value": "",
  "cashierBankCode": "",
  "txid": "",
  "additionalInfo": "",
  "emitImage": true,
  "merchant": {
    "name": "",
    "city": "",
    "taxId": ""
  }
}'

Show Schema

{
  "id": "string",
  "type": "STATIC",
  "key": "string",
  "value": "string",
  "merchant": {
    "name": "string",
    "city": "string",
    "taxId": "string"
  },
  "txid": "string",
  "additionalInfo": "string",
  "brCode": "string",
  "qrCodeImage": {
    "contentType": "string",
    "base64": "string"
  },
  "createdAt": "2026-09-16T19:14:18.660Z"
}

QR Code generated successfully