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 Pattern: ^\d{8}$

    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 Pattern: ^\d+\.\d{2}$

    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
  • application/json
  • application/json
  • application/json
Request Example for post/api/v1/charges/static
curl http://localhost:8080/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": ""
  }
}'

{
  "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-07-29T19:28:46.562Z"
}

QR Code generated successfully