ChargeStaticRequestDTO

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 · MerchantDataRequestDTO
    required

    Merchant (receiver) information for EMV payload composition

    • city
      Type: string
      min length:  
      1
      required

      Merchant city (EMV ID 60).

    • name
      Type: string
      min length:  
      1
      required

      Merchant name (EMV ID 59).

    • taxId
      Type: string
      min length:  
      1
      required

      Merchant tax ID (CPF/CNPJ).

  • 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).