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

# Criar transferência

> Envia um pagamento Pix para qualquer chave Pix. Criado e aprovado automaticamente.



## OpenAPI

````yaml POST /bank-transfer
openapi: 3.0.0
info:
  title: payera-api
  description: Documentação de endpoints e entidades da payera
  version: '1.0'
  contact: {}
servers:
  - url: https://api.rivoopay.com
security:
  - ApiKeyAuth: []
paths:
  /bank-transfer:
    post:
      tags:
        - Bank Transfer
      summary: Criar transferência bancária
      description: >-
        Envia um pagamento Pix para qualquer chave Pix. Criado e aprovado
        automaticamente.
      operationId: BankTransferController_createTransfer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateBankTransferDto'
      responses:
        '201':
          description: Transferência criada com sucesso
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BankTransferResponseDto'
        '400':
          description: Dados inválidos ou saldo insuficiente
        '401':
          description: Não autorizado
        '422':
          description: Empresa não possui conta RivooPay aprovada
components:
  schemas:
    CreateBankTransferDto:
      type: object
      properties:
        value:
          type: number
          example: 1500
          description: 'Valor em centavos (mínimo: 101 = R$ 1,01)'
        destination:
          $ref: '#/components/schemas/BankTransferDestinationDto'
        description:
          type: string
          example: Pagamento ao fornecedor XYZ
          description: Descrição opcional
        correlationID:
          type: string
          example: transfer_abc123
          description: ID único para idempotência. Gerado automaticamente se não fornecido.
      required:
        - value
        - destination
    BankTransferResponseDto:
      type: object
      properties:
        status:
          type: number
        message:
          type: string
        data:
          $ref: '#/components/schemas/WooviPaymentResponseDto'
      required:
        - status
        - message
        - data
    BankTransferDestinationDto:
      type: object
      properties:
        alias:
          type: string
          example: usuario@email.com
          description: >-
            Chave Pix do destinatário (CPF, CNPJ, email, telefone ou chave
            aleatória)
        type:
          type: string
          example: EMAIL
          description: Tipo da chave Pix
          enum:
            - CPF
            - CNPJ
            - EMAIL
            - PHONE
            - RANDOM
      required:
        - alias
        - type
    WooviPaymentResponseDto:
      type: object
      properties:
        paymentId:
          type: string
          example: payment_123456
          description: ID do pagamento na Woovi
        correlationID:
          type: string
          example: correlationID_abc
          description: ID de correlação fornecido
        value:
          type: number
          example: 10000
          description: Valor do pagamento em centavos
        status:
          type: string
          example: CREATED
          description: Status do pagamento (CREATED, APPROVED, CONFIRMED, CANCELLED)
        createdAt:
          type: string
          example: '2025-12-15T12:00:00.000Z'
          description: Data de criação do pagamento
        endToEndId:
          type: string
          example: E18236120202012032010s0133872GZA
          description: End to end ID (disponível após confirmação)
      required:
        - paymentId
        - correlationID
        - value
        - status
        - createdAt
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````