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

# Create immediate Pix charge

> Creates an immediate Pix charge and returns the BR Code as text (`pix.emv`) and as an image (`pix.qrCode`).



## OpenAPI

````yaml /openapi.yaml post /pix/in/qrcode
openapi: 3.0.3
info:
  title: Fincle API
  version: 1.0.0
  description: >-
    Fincle payments API: charges by Pix, credit card and boleto, subscriptions,
    transactions, refunds, infractions, notifications and transfers.
servers:
  - url: https://api.fincle.com.br
    description: Production server
security: []
tags:
  - name: Authentication
    description: Issuance of the access token from the API key.
  - name: Charges
    description: Creation of charges by Pix, credit card and boleto.
  - name: Subscriptions
    description: Recurring billing on credit card.
  - name: Transactions
    description: Retrieval and refund of transactions.
  - name: Refunds
    description: Refund requests submitted by payers.
  - name: Infractions and MED
    description: Pix infraction reports and the amounts blocked as a result.
  - name: Webhooks
    description: Registration of notification endpoints and tracking of deliveries.
  - name: Balance and transfers
    description: Balance, statement, fees and transfer of the amounts received.
paths:
  /pix/in/qrcode:
    post:
      tags:
        - Charges
      summary: Create immediate Pix charge
      description: >-
        Creates an immediate Pix charge and returns the BR Code as text
        (`pix.emv`) and as an image (`pix.qrCode`).
      operationId: createPixQrCode
      parameters:
        - name: Idempotency-Key
          in: header
          required: false
          schema:
            type: string
          description: >-
            Idempotency key of the request. Repeating the request with the same
            key returns the transaction already recorded, without creating a new
            charge. A universally unique identifier (UUID) is recommended.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                postbackUrl:
                  type: string
                  format: uri
                description:
                  type: string
                amountInCents:
                  type: integer
                  exclusiveMinimum: true
                  minimum: 0
                items:
                  type: array
                  items:
                    type: object
                    properties:
                      title:
                        type: string
                      tangible:
                        type: boolean
                      quantity:
                        type: integer
                        minimum: 1
                        maximum: 100000
                      amountInCents:
                        type: integer
                        minimum: 0
                      shippingAddress:
                        type: object
                        properties:
                          street:
                            type: string
                          number:
                            type: string
                          neighborhood:
                            type: string
                          city:
                            type: string
                          state:
                            type: string
                          zipCode:
                            type: string
                        required:
                          - street
                          - number
                          - neighborhood
                          - city
                          - state
                          - zipCode
                        additionalProperties: false
                    required:
                      - title
                      - tangible
                      - quantity
                      - amountInCents
                    additionalProperties: false
                customer:
                  type: object
                  properties:
                    name:
                      type: string
                    email:
                      type: string
                      format: email
                    documentType:
                      type: string
                      enum:
                        - cpf
                        - cnpj
                    document:
                      type: string
                    phone:
                      type: string
                    instagram:
                      type: string
                    billingAddress:
                      type: object
                      properties:
                        street:
                          type: string
                        number:
                          type: string
                        neighborhood:
                          type: string
                        city:
                          type: string
                        state:
                          type: string
                        zipCode:
                          type: string
                      required:
                        - street
                        - number
                        - neighborhood
                        - city
                        - state
                        - zipCode
                      additionalProperties: false
                  required:
                    - documentType
                    - document
                  additionalProperties: false
                seller:
                  type: object
                  properties:
                    name:
                      type: string
                    documentType:
                      type: string
                      enum:
                        - cpf
                        - cnpj
                    document:
                      type: string
                    phone:
                      type: string
                    averageTicket:
                      type: number
                    address:
                      type: object
                      properties:
                        street:
                          type: string
                        number:
                          type: string
                        neighborhood:
                          type: string
                        city:
                          type: string
                        state:
                          type: string
                        zipCode:
                          type: string
                      required:
                        - street
                        - number
                        - neighborhood
                        - city
                        - state
                        - zipCode
                      additionalProperties: false
                  required:
                    - name
                    - documentType
                    - document
                  additionalProperties: false
              required:
                - amountInCents
                - customer
              additionalProperties: false
            example:
              amountInCents: 4990
              description: Invoice no. 2026/001042
              postbackUrl: https://api.example.com/webhooks/fincle
              customer:
                name: Helena Martins Andrade
                email: helena.andrade@example.com
                documentType: cpf
                document: '31845792041'
                phone: '11932104567'
      responses:
        '200':
          description: Request processed successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      pix:
                        type: object
                        properties:
                          emv:
                            type: string
                          qrCode:
                            type: string
                        required:
                          - emv
                          - qrCode
                        additionalProperties: false
                      status:
                        type: string
                      fees:
                        type: number
                      data: {}
                    required:
                      - id
                      - pix
                      - status
                      - fees
                    additionalProperties: false
                required:
                  - success
                  - message
                additionalProperties: false
              example:
                success: true
                message: Transação criada com sucesso
                data:
                  id: cmddiqpxo09zf1yju2kqkhgga
                  pix:
                    emv: >-
                      00020126870014br.gov.bcb.pix2565pix.example.com/qr/v3/at/7fab0715...6304F801
                    qrCode: data:image/png;base64,iVBORw0KGgo...
                  status: pending
                  fees: 150
        '400':
          description: Request rejected due to a validation failure or a business rule.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                required:
                  - success
                  - message
              example:
                success: false
                message: Documento inválido para o tipo selecionado
        '401':
          description: Access token missing, invalid or expired.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    type: string
                required:
                  - success
                  - message
              example:
                success: false
                message: Não autorizado
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````

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