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

# Request Withdraw

> Pede o saque de parte do saldo do afiliado.
<Note>O valor precisa alcançar o mínimo da loja e caber no saldo, e os dados de PIX precisam estar preenchidos. O pedido entra como `WITHDRAW_PENDING` no extrato e é o lojista quem aprova.</Note>



## OpenAPI

````yaml /openapi/storefront-affiliate.yaml post /webstore/affiliate/withdrawals
openapi: 3.1.0
info:
  title: CentralCart Storefront API (Afiliados)
  version: 1.0.0
  description: >-
    Programa de afiliados da loja, na visão do comprador que indica. Todas as
    rotas exigem a sessão do cliente, exceto a que resolve um código de
    indicação.
servers:
  - url: https://api.centralcart.io/v1
    description: Produção
security:
  - customerAuth: []
paths:
  /webstore/affiliate/withdrawals:
    post:
      tags:
        - Afiliados
      summary: Request Withdraw
      description: >-
        Pede o saque de parte do saldo do afiliado.

        <Note>O valor precisa alcançar o mínimo da loja e caber no saldo, e os
        dados de PIX precisam estar preenchidos. O pedido entra como
        `WITHDRAW_PENDING` no extrato e é o lojista quem aprova.</Note>
      operationId: requestWebstoreAffiliateWithdraw
      parameters:
        - $ref: '#/components/parameters/StoreDomain'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - amount
              properties:
                amount:
                  type: number
                  description: Valor a sacar.
            example:
              amount: 50
      responses:
        '200':
          description: Saque solicitado
        '400':
          description: Saldo insuficiente, valor abaixo do mínimo, ou dados de PIX faltando
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                Saldo insuficiente:
                  value:
                    errors:
                      - message: Saldo insuficiente
                Abaixo do mínimo:
                  value:
                    errors:
                      - message: O valor mínimo para saque é R$ 5,00
                Sem dados de PIX:
                  value:
                    errors:
                      - message: >-
                          Configure as informações de saque antes de solicitar
                          um saque.
        '401':
          $ref: '#/components/responses/CustomerUnauthorized'
        '404':
          $ref: '#/components/responses/AffiliateNotFound'
components:
  parameters:
    StoreDomain:
      name: x-store-domain
      in: header
      required: true
      description: 'Domínio da sua loja (ex: sualoja.centralcart.ai)'
      schema:
        type: string
  schemas:
    Error:
      type: object
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              ref:
                type: string
  responses:
    CustomerUnauthorized:
      description: Sessão do cliente ausente, inválida ou expirada
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            errors:
              - message: Sessão inválida ou expirada.
                code: CUSTOMER_UNAUTHENTICATED
    AffiliateNotFound:
      description: O cliente autenticado não é afiliado desta loja
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            errors:
              - message: Afiliado não encontrado
  securitySchemes:
    customerAuth:
      type: http
      scheme: bearer
      description: '`access_token` do comprador, devolvido por `POST /webstore/auth/verify`.'

````