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

# Enviar PIX

> Permite que você envie dinheiro via PIX para qualquer chave PIX que não seja do titular da conta.

Você pode usar esta rota para:
- **Enviar pagamentos** para fornecedores, parceiros ou terceiros
- **Realizar transferências** para contas de outras pessoas ou empresas
- **Efetuar pagamentos** diretamente pela API

**Importante**: Esta funcionalidade é diferente dos payouts, pois permite enviar dinheiro para chaves PIX que não pertencem ao titular da conta. Use payouts quando quiser enviar para sua própria chave PIX.


Envia dinheiro para qualquer chave PIX de terceiros — fornecedores, parceiros ou colaboradores.

<Card horizontal>
  Requer a permissão `WITHDRAW:CREATE`.
</Card>

<Note>
  **PIX vs Saques:** use **PIX** para enviar a chaves de terceiros. Para sacar para a sua própria chave use [Saques](/pages/payouts/create).
</Note>

**Exemplo:**

```json theme={null}
{
  "amount": 10000,
  "description": "Pagamento fornecedor #42",
  "externalId": "pix-123",
  "pixKey": "contato@fornecedor.com",
  "pixKeyType": "EMAIL"
}
```

**Tipos de chave PIX aceitos:**

| `pixKeyType` | Exemplo               |
| ------------ | --------------------- |
| `CPF`        | `12345678901`         |
| `CNPJ`       | `12345678000190`      |
| `PHONE`      | `11987654321`         |
| `EMAIL`      | `contato@exemplo.com` |
| `RANDOM`     | UUID aleatório        |
| `BR_CODE`    | Código completo do QR |

<Tip title="Limites" horizontal>
  Valor mínimo: R\$ 1,00. O processamento é instantâneo e disponível 24/7.
</Tip>


## OpenAPI

````yaml POST /pix/send
openapi: 3.1.0
info:
  title: API AbacatePay
  description: API para gerenciamento de cobranças e pagamentos usando o AbacatePay.
  version: 1.0.0
servers:
  - url: https://api.abacatepay.com/v2
    description: Único servidor para os ambientes de produção e sandbox.
security: []
paths:
  /pix/send:
    post:
      summary: Enviar PIX
      description: >
        Permite que você envie dinheiro via PIX para qualquer chave PIX que não
        seja do titular da conta.


        Você pode usar esta rota para:

        - **Enviar pagamentos** para fornecedores, parceiros ou terceiros

        - **Realizar transferências** para contas de outras pessoas ou empresas

        - **Efetuar pagamentos** diretamente pela API


        **Importante**: Esta funcionalidade é diferente dos payouts, pois
        permite enviar dinheiro para chaves PIX que não pertencem ao titular da
        conta. Use payouts quando quiser enviar para sua própria chave PIX.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              description: Dados necessários para enviar um PIX.
              required:
                - amount
                - externalId
                - pix
              additionalProperties: false
              example:
                amount: 10000
                externalId: pix-123
                description: Pagamento para fornecedor
                pix:
                  key: '11987654321'
                  type: PHONE
              properties:
                amount:
                  type: number
                  description: Valor do PIX em centavos.
                  minimum: 1
                  example: 10000
                externalId:
                  type: string
                  description: Identificador único do PIX em seu sistema.
                  example: pix-123
                description:
                  type: string
                  description: Descrição opcional do PIX.
                  example: Pagamento para fornecedor
                  x-mint:
                    hidden: true
                pix:
                  type: object
                  description: Dados da chave PIX de destino.
                  required:
                    - key
                    - type
                  additionalProperties: false
                  properties:
                    key:
                      type: string
                      description: Chave PIX de destino.
                      example: '11987654321'
                    type:
                      type: string
                      description: Tipo da chave PIX.
                      enum:
                        - CPF
                        - CNPJ
                        - PHONE
                        - EMAIL
                        - RANDOM
                        - BR_CODE
                      example: PHONE
      responses:
        '200':
          description: PIX enviado com sucesso.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/PixTransaction'
                  error:
                    type: string
                    nullable: true
                    example: null
                  success:
                    $ref: '#/components/schemas/Success'
        '401':
          description: Não autorizado. Falha na autenticação.
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: >-
                      Mensagem de erro descrevendo o motivo da falha na
                      autenticação.
                    example: Token de autenticação inválido ou ausente.
      security:
        - bearerAuth: []
components:
  schemas:
    PixTransaction:
      type: object
      description: Dados de uma transação PIX.
      properties:
        id:
          type: string
          description: Identificador único da transação PIX.
          example: txn_abc123xyz
        status:
          type: string
          description: Status atual da transação.
          enum:
            - PENDING
            - EXPIRED
            - CANCELLED
            - COMPLETE
            - REFUNDED
          example: PENDING
        devMode:
          type: boolean
          description: Indica se a transação foi criada em ambiente de testes.
          example: false
        receiptUrl:
          type: string
          format: uri
          description: URL do comprovante da transação.
          example: https://app.abacatepay.com/receipt/txn_abc123xyz
        amount:
          type: number
          description: Valor da transação em centavos.
          example: 10000
        platformFee:
          type: number
          description: Taxa da plataforma em centavos.
          example: 100
        externalId:
          type: string
          nullable: true
          description: Identificador externo da transação.
          example: pix-123
        createdAt:
          type: string
          format: date-time
          description: Data de criação da transação.
          example: '2024-11-04T18:38:28.573Z'
        updatedAt:
          type: string
          format: date-time
          description: Data de atualização da transação.
          example: '2024-11-04T18:38:28.573Z'
      required:
        - id
        - status
        - devMode
        - receiptUrl
        - amount
        - platformFee
        - createdAt
        - updatedAt
    Success:
      type: boolean
      description: Se a requisição obteve sucesso ou não.
      example: true
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >
        Todas as requisições devem incluir sua chave de API no header
        Authorization usando o formato `Bearer <abacatepay-api-key>`. Sem esse
        header a requisição será rejeitada.


        Saiba mais sobre como criar e usar chaves de API na [documentação de
        autenticação](/pages/authentication).

````