> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trio.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Create static QR code

> Create a new static QRCode



## OpenAPI

````yaml v2/api-reference/openapi.json POST /v2/in/pix/qrcodes/static
openapi: 3.0.0
info:
  title: Trio API v2
  version: 2026-10-19.v2
servers:
  - url: https://api.sandbox.trio.com.br
    variables: {}
  - url: https://api.qa.trio.com.br
    variables: {}
  - url: https://api.trio.com.br
    variables: {}
security: []
tags: []
paths:
  /v2/in/pix/qrcodes/static:
    parameters:
      - description: >-
          Version of the v2 contract the client is written against. Each
          breaking change publishes a new version.
        example: 2026-10-19.v2
        in: header
        name: Trio-Version
        required: true
        schema:
          enum:
            - 2026-10-19.v2
          type: string
          x-struct: null
          x-validate: null
      - description: >-
          ID of another org to act on instead of the API key's own org. The
          key's org must have been granted access to it, and the request is
          refused with 403 FORBIDDEN otherwise. When that access or the API key
          is read-only, only GET and HEAD requests may carry it. When the target
          org requires mTLS, so does the request. Leave it out to act on the
          key's own org.
        in: header
        name: Trio-Target-Org-Id
        required: false
        schema:
          format: uuid
          type: string
          x-struct: null
          x-validate: null
    post:
      tags:
        - Receivables (in)
        - Pix
        - Static
      summary: Create a new static QRCode
      description: Create a new static QRCode
      operationId: TrioFoundationWeb.V2.In.Pix.Qrcode.StaticController.create
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/V2_Static_QRCode_payload'
        description: The static QRCode payload
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_Static_QRCode_single_response'
          description: StaticBrcode
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: >-
            Malformed request: a body that is not valid JSON
            (MALFORMED_REQUEST), or a Trio-Version header that is missing or not
            the current one (INVALID_TRIO_VERSION).
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: Missing or invalid API key credentials (INVALID_CREDENTIALS).
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: >-
            The API key may not do this (FORBIDDEN): for instance
            Trio-Target-Org-Id names an org it has no access to, or writes
            through a read-only access.
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: >-
            Invalid input (INVALID_PARAMETER, REQUIRED_PARAMETER, or the code of
            the rule the request breaks). A request outside the operation's
            schema lists the offending fields in `errors`.
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V2_error'
          description: >-
            A service needed to answer is unavailable
            (TRIO_SERVICE_UNAVAILABLE).
      callbacks: {}
      security:
        - authorization: []
components:
  schemas:
    V2_Static_QRCode_payload:
      description: Body params to create a static QRCode
      example:
        amount: 2000
        bank_account_id: 01919020-51ee-527b-5147-3feacb8ea333
        description: description
        external_id: external_id
        options:
          fee: 0
          show_qrcode_image: false
      properties:
        amount:
          description: >-
            Amount in cents. Send 0 for an open-amount code: the payer chooses
            the amount.
          minimum: 0
          type: integer
          x-struct: null
          x-validate: null
        bank_account_id:
          description: Bank account ID
          type: string
          x-struct: null
          x-validate: null
        description:
          description: Description of the static QRCode
          type: string
          x-struct: null
          x-validate: null
        external_id:
          description: External ID of the static QRCode
          type: string
          x-struct: null
          x-validate: null
        merchant:
          description: >-
            Merchant to register as the split org merchant. When sent, it is
            saved.
          nullable: true
          properties:
            name:
              description: Merchant name
              type: string
              x-struct: null
              x-validate: null
            tax_number:
              description: Merchant tax number
              type: string
              x-struct: null
              x-validate: null
          required:
            - name
            - tax_number
          type: object
          x-struct: null
          x-validate: null
        options:
          description: Create options
          properties:
            fee:
              description: Fee
              nullable: true
              type: integer
              x-struct: null
              x-validate: null
            show_qrcode_image:
              description: Show static QRCode image
              type: boolean
              x-struct: null
              x-validate: null
          required:
            - show_qrcode_image
          type: object
          x-struct: null
          x-validate: null
        platform_id:
          description: Platform ID of the static QRCode
          nullable: true
          type: string
          x-struct: null
          x-validate: null
        splits:
          description: Cashin split configurations
          items:
            properties:
              counterparty_recipient_id:
                description: Counterparty recipient UUID
                type: string
                x-struct: null
                x-validate: null
              type:
                description: Split type
                enum:
                  - percentage
                  - fixed
                type: string
                x-struct: null
                x-validate: null
              value:
                description: Percentage (0-100) or fixed amount in cents
                type: integer
                x-struct: null
                x-validate: null
            required:
              - type
              - value
              - counterparty_recipient_id
            type: object
            x-struct: null
            x-validate: null
          nullable: true
          type: array
          x-struct: null
          x-validate: null
      required:
        - amount
        - bank_account_id
        - options
      title: V2 Static QRCode payload
      type: object
      x-struct: >-
        Elixir.TrioFoundationWeb.Schemas.Banking.V2.Cashin.StaticBrcode.CreateParams
      x-validate: null
    V2_Static_QRCode_single_response:
      description: Response for a single static QRCode
      example:
        data:
          amount:
            amount: 10
            currency: BRL
          bank_account_id: 019252ca-4859-55f0-0f20-6f02250b5acd
          description: description
          external_id: external_id
          fee:
            amount: 0
            currency: BRL
          hash: >-
            00020126580014br.gov.bcb.pix0136019252ca-48b2-e95e-c398-3133a04a5b3e52040000530398654040.105802BR5911brcode_name6011brcode_city622605222HwV3MJojKRR2FxvgYTgYF6304C4D0
          id: 019252ca-4a5b-b711-2371-0a0142807c75
          inserted_at: '2024-10-03T14:30:42.011732Z'
          origin:
            id: null
            type: null
          status: created
          updated_at: '2024-10-03T14:30:42.011732Z'
      properties:
        data:
          $ref: '#/components/schemas/V2_Static_QRCode_response'
      title: V2 Static QRCode single response
      type: object
      x-struct: Elixir.TrioFoundationWeb.Schemas.Banking.V2.Cashin.StaticBrcode.Response
      x-validate: null
    V2_error:
      example:
        error:
          error_code: INVALID_PARAMETER
          error_message: 'Invalid parameters: /amount: Invalid integer. Got: string'
          errors:
            - field: /amount
              message: 'Invalid integer. Got: string'
      properties:
        error:
          properties:
            error_code:
              description: >-
                Stable UPPER_SNAKE identifier of the error, for programs and
                logs. Branch on this, not on the message.
              type: string
              x-struct: null
              x-validate: null
            error_message:
              description: Human readable explanation of the error.
              type: string
              x-struct: null
              x-validate: null
            errors:
              description: >-
                Only on INVALID_PARAMETER for a request outside the operation's
                schema: one entry per offending field.
              items:
                properties:
                  field:
                    description: JSON pointer to the field, e.g. /amount.
                    type: string
                    x-struct: null
                    x-validate: null
                  message:
                    description: What is wrong with it.
                    type: string
                    x-struct: null
                    x-validate: null
                required:
                  - field
                  - message
                type: object
                x-struct: null
                x-validate: null
              type: array
              x-struct: null
              x-validate: null
          required:
            - error_code
            - error_message
          type: object
          x-struct: null
          x-validate: null
      required:
        - error
      title: V2 error
      type: object
      x-struct: Elixir.TrioFoundationWeb.Schemas.HTTP.V2Error
      x-validate: null
    V2_Static_QRCode_response:
      description: >-
        A static QRCode, as returned by show and create. `image` is present only
        when create was asked for it with `options.show_qrcode_image`.
      example:
        amount:
          amount: 10
          currency: BRL
        bank_account_id: 019252ca-4859-55f0-0f20-6f02250b5acd
        description: description
        external_id: external_id
        fee:
          amount: 0
          currency: BRL
        hash: >-
          00020126580014br.gov.bcb.pix0136019252ca-48b2-e95e-c398-3133a04a5b3e52040000530398654040.105802BR5911brcode_name6011brcode_city622605222HwV3MJojKRR2FxvgYTgYF6304C4D0
        id: 019252ca-4a5b-b711-2371-0a0142807c75
        inserted_at: '2024-10-03T14:30:42.011732Z'
        origin:
          id: null
          type: null
        status: created
        updated_at: '2024-10-03T14:30:42.011732Z'
      properties:
        amount:
          description: Amount value of the static QRCode
          properties:
            amount:
              description: Amount integer
              minimum: 0
              type: integer
              x-struct: null
              x-validate: null
            currency:
              description: Amount currency string
              type: string
              x-struct: null
              x-validate: null
          type: object
          x-struct: null
          x-validate: null
        bank_account_id:
          description: Bank account that receives the payments
          format: uuid
          type: string
          x-struct: null
          x-validate: null
        description:
          description: Description
          type: string
          x-struct: null
          x-validate: null
        external_id:
          description: External ID
          nullable: true
          type: string
          x-struct: null
          x-validate: null
        fee:
          description: Fee charged on each payment
          nullable: true
          properties:
            amount:
              description: Fee in cents
              type: integer
              x-struct: null
              x-validate: null
            currency:
              description: Currency
              type: string
              x-struct: null
              x-validate: null
          type: object
          x-struct: null
          x-validate: null
        hash:
          description: QRCode hash (Pix copy and paste)
          type: string
          x-struct: null
          x-validate: null
        id:
          description: Static QRCode ID
          format: uuid
          type: string
          x-struct: null
          x-validate: null
        image:
          description: Base64 QRCode image, only when requested on create
          type: string
          x-struct: null
          x-validate: null
        inserted_at:
          description: When the QRCode was created
          format: date-time
          type: string
          x-struct: null
          x-validate: null
        origin:
          description: Who or what created the QRCode
          properties:
            id:
              description: Origin ID
              format: uuid
              nullable: true
              type: string
              x-struct: null
              x-validate: null
            type:
              description: 'Origin type: `none`, `api_client` or `console_user`'
              nullable: true
              type: string
              x-struct: null
              x-validate: null
          type: object
          x-struct: null
          x-validate: null
        status:
          description: Static QRCode status
          enum:
            - created
            - deleted
          type: string
          x-struct: null
          x-validate: null
        updated_at:
          description: When the QRCode was last updated
          format: date-time
          type: string
          x-struct: null
          x-validate: null
      title: V2 Static QRCode response
      type: object
      x-struct: >-
        Elixir.TrioFoundationWeb.Schemas.Banking.V2.Cashin.StaticBrcode.QrCodeData
      x-validate: null
  securitySchemes:
    authorization:
      scheme: basic
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.