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

# Enviar transferência PIX

> Realiza transferência PIX para qualquer chave PIX



## OpenAPI

````yaml /openapi.yaml post /api/v1/pix/out/pixkey
openapi: 3.1.0
info:
  title: API Quantum Pay
  description: >-
    API para gerenciamento de pagamentos PIX da Quantum Pay. Permite criar QR
    codes para recebimento, realizar transferências PIX e gerenciar webhooks.
  version: 1.0.0
  contact:
    name: Quantum Pay
    email: contato@quantumhubpay.com
    url: https://quantumpay.com.br
servers:
  - url: https://api.quantumpay.com.br
    description: Ambiente de produção
security: []
tags:
  - name: Autenticação
    description: Endpoints para autenticação e geração de tokens
  - name: Empresa
    description: Endpoints para consulta de dados da empresa
  - name: PIX IN
    description: Endpoints para recebimento de pagamentos PIX
  - name: PIX OUT
    description: Endpoints para envio de transferências PIX
  - name: Webhooks
    description: Endpoints para gerenciamento de webhooks
paths:
  /api/v1/pix/out/pixkey:
    post:
      tags:
        - PIX OUT
      summary: Enviar transferência PIX
      description: Realiza transferência PIX para qualquer chave PIX
      parameters:
        - name: x-idempotency-key
          in: header
          required: true
          schema:
            type: string
          description: Chave de idempotência para evitar duplicações
          example: idempotency_exemplo_001
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - pixKey
                - amount
              properties:
                pixKey:
                  type: string
                  description: >-
                    Chave PIX de destino (CPF, CNPJ, email, telefone ou chave
                    aleatória)
                  example: fornecedor@exemplo.com
                amount:
                  type: integer
                  minimum: 1
                  description: Valor da transferência em centavos
                  example: 10000
                currency:
                  type: string
                  description: Moeda da transferência (apenas BRL aceito)
                  default: BRL
                  example: BRL
                description:
                  type: string
                  maxLength: 140
                  description: Descrição da transferência
                  example: Transfer PIX Exemplo
                postbackUrl:
                  type: string
                  format: uri
                  description: URL para receber notificações de status da transferência
                  example: https://exemplo.com.br/webhook/pix-out
      responses:
        '201':
          description: Transferência iniciada com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PixTransferResponse'
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '409':
          description: Chave de idempotência já utilizada
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '429':
          $ref: '#/components/responses/RateLimited'
      security:
        - bearerAuth: []
components:
  schemas:
    PixTransferResponse:
      type: object
      properties:
        success:
          type: boolean
          description: Indica se a operação foi bem-sucedida
          example: true
        message:
          type: string
          description: Mensagem de retorno
          example: Transferência criada com sucesso
        data:
          type: object
          properties:
            id:
              type: string
              description: ID único da transferência
              example: transfer_abc123def456
            status:
              type: string
              enum:
                - queued
                - processing
                - completed
                - canceled
              description: Status da transferência
              example: queued
            amount:
              type: integer
              description: Valor total da transferência em centavos
              example: 10000
            netAmount:
              type: integer
              description: Valor líquido após dedução de taxas em centavos
              example: 10000
            fees:
              type: integer
              description: Taxa cobrada em centavos
              example: 0
            pixKey:
              type: string
              description: Chave PIX de destino
              example: fornecedor@exemplo.com
    Error:
      type: object
      properties:
        error:
          type: string
          description: Código do erro
          example: INVALID_REQUEST
        message:
          type: string
          description: Mensagem de erro
          example: O campo 'amount' é obrigatório
        details:
          type: object
          description: Detalhes adicionais do erro
          additionalProperties: true
  responses:
    BadRequest:
      description: Requisição inválida
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unauthorized:
      description: Não autorizado
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: UNAUTHORIZED
            message: Token de autenticação inválido ou expirado
    RateLimited:
      description: Limite de taxa excedido
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error: RATE_LIMITED
            message: Muitas requisições. Tente novamente em alguns minutos.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Token JWT no cabeçalho Authorization

````