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

# Solicitar saque

> Cria uma nova solicitação de saque. O tipo de saque determina a estrutura específica dos dados necessários.

**Operação em subconta:**
Para criar um saque em subconta, inclua o header `x-subaccount-id` com o ID da subconta. Quando este header é fornecido, a operação será realizada no contexto da subconta especificada, em vez da conta principal autenticada.



## OpenAPI

````yaml POST /withdrawals/withdraw
openapi: 3.1.0
info:
  title: OpenAPI Super APIs
  description: Documentação das APIs destinada a companhias da Super Pagamentos
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://sandbox-api.superpagamentos.com
    description: Ambiente de desenvolvimento
  - url: https://api.superpagamentos.com
    description: Ambiente de produção
security: []
paths:
  /withdrawals/withdraw:
    post:
      description: >-
        Cria uma nova solicitação de saque. O tipo de saque determina a
        estrutura específica dos dados necessários.


        **Operação em subconta:**

        Para criar um saque em subconta, inclua o header `x-subaccount-id` com o
        ID da subconta. Quando este header é fornecido, a operação será
        realizada no contexto da subconta especificada, em vez da conta
        principal autenticada.
      parameters:
        - name: x-subaccount-id
          in: header
          description: >-
            ID da subconta onde a operação será realizada. Quando fornecido, a
            operação será executada no contexto desta subconta específica.
          required: false
          schema:
            type: string
            format: uuid
      requestBody:
        description: >-
          Payload para criação de um novo saque. O tipo de saque determina a
          estrutura específica dos dados necessários.
        content:
          application/json:
            schema:
              oneOf:
                - title: Saque PIX
                  type: object
                  required:
                    - withdrawalMethod
                    - amount
                    - bankAccountId
                    - pixKeyType
                    - pixKey
                  properties:
                    withdrawalMethod:
                      type: string
                      enum:
                        - pix
                      description: Método de pagamento que terá o saldo debitado
                    amount:
                      type: integer
                      description: >-
                        Valor do saque em centavos. O valor mínimo para saque é
                        100 (R$ 1,00)
                      example: 10000
                      minimum: 100
                    bankAccountId:
                      type: integer
                      description: ID da conta bancária que receberá o saque
                      example: 1234567890
                    pixKeyType:
                      type: string
                      description: Tipo da chave PIX
                      example: CPF
                      enum:
                        - DOCUMENT_CPF
                        - DOCUMENT_CNPJ
                        - EMAIL
                        - PHONE
                        - RANDOM
                    pixKey:
                      type: string
                      description: Chave PIX
                      example: '1234567890'
                    postbackUrl:
                      type: string
                      description: >-
                        URL de callback para recebimento de notificações de
                        saque
                      example: https://example.com/callback
                  additionalProperties: false
                - title: Saque Cartão
                  type: object
                  required:
                    - withdrawalMethod
                    - amount
                    - bankAccountId
                  properties:
                    withdrawalMethod:
                      type: string
                      enum:
                        - card
                      description: Método de pagamento que terá o saldo debitado
                    amount:
                      type: integer
                      description: >-
                        Valor do saque em centavos. O valor mínimo para saque é
                        100 (R$ 1,00)
                      example: 10000
                      minimum: 100
                    bankAccountId:
                      type: integer
                      description: ID da conta bancária que receberá o saque
                      example: 1234567890
                    postbackUrl:
                      type: string
                      description: >-
                        URL de callback para recebimento de notificações de
                        saque
                      example: https://example.com/callback
                  additionalProperties: false
                - title: Saque Boleto
                  type: object
                  required:
                    - withdrawalMethod
                    - amount
                    - bankAccountId
                  properties:
                    withdrawalMethod:
                      type: string
                      enum:
                        - billet
                      description: Método de pagamento que terá o saldo debitado
                    amount:
                      type: integer
                      description: >-
                        Valor do saque em centavos. O valor mínimo para saque é
                        100 (R$ 1,00)
                      example: 10000
                      minimum: 100
                    bankAccountId:
                      type: integer
                      description: ID da conta bancária que receberá o saque
                      example: 1234567890
                    postbackUrl:
                      type: string
                      description: >-
                        URL de callback para recebimento de notificações de
                        saque
                      example: https://example.com/callback
                  additionalProperties: false
        required: true
      responses:
        '201':
          description: Saque solicitado com sucesso
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties: {}
                  message:
                    type: string
                    example: Saque solicitado com sucesso
              examples:
                Saque PIX:
                  value:
                    data:
                      id: 5509e70d-fa20-4103-84c6-27370138948b
                      amount: 10000
                      liquidAmount: 9990
                      status: PENDING
                      pixKeyType: CPF
                      pixKey: '1234567890'
                      createdAt: '2025-06-09T19:14:20.125Z'
                      updatedAt: '2025-06-09T19:14:20.125Z'
                    message: Pagamento PIX criado com sucesso
                Saque Cartão e Boleto:
                  value:
                    data:
                      id: 5509e70d-fa20-4103-84c6-27370138948b
                      amount: 10000
                      liquidAmount: 9990
                      status: PENDING
                      createdAt: '2025-06-09T19:14:20.125Z'
                      updatedAt: '2025-06-09T19:14:20.125Z'
                    message: Pagamento PIX criado com sucesso
        '400':
          description: Erro ao criar pagamento
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      message:
                        type: string
                      returnCode:
                        type: integer
              examples:
                Saldo insuficiente:
                  value:
                    data:
                      message: Saldo insuficiente para realizar o saque
                      returnCode: -7711
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token JWT gerado na rota de autenticação (/auth). Deve ser enviado no
        formato: Bearer <token>

````