Criar Saque

Crie solicitações de saque via PIX para transferir seu saldo disponível para sua conta bancária.

Endpoint

POST /v1/payouts

Parâmetros

Parâmetro Tipo Obrigatório Descrição
amount number Sim Valor do saque em reais (ex: 100.50). O valor será convertido para centavos internamente.
payout_method_id integer Não ID do método de saque cadastrado (usa o padrão se omitido)

Exemplo de Requisição (Método Cadastrado)

curl -X POST https://api.apexpy.com.br/v1/payouts \
  -H "Authorization: Bearer YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 100.50,
    "payout_method_id": 1,
    "description": "Saque para minha conta"
  }'

Exemplo de Resposta

{
  "success": true,
  "data": {
    "id": "co_123",
    "status": "pending",
    "amount": 10050,
    "currency": "BRL",
    "created_at": "2025-11-28T20:30:00Z"
  }
}

Validações

Segurança e Compliance

Importante - Política de Compliance:

Por questões de Compliance e segurança regulatória, todas as operações de Cash-out (saques e transferências) são realizadas exclusivamente para a chave PIX vinculada ao cadastro do seller/empresa.

Esta medida é fundamental para:

  • Prevenir lavagem de dinheiro e financiamento ilícito
  • Garantir a rastreabilidade das operações financeiras
  • Cumprir as exigências do Banco Central do Brasil e demais órgãos reguladores
  • Proteger tanto o seller quanto a plataforma de fraudes e operações irregulares
  • Assegurar que os recursos sejam transferidos apenas para o titular da conta verificado

Para garantir segurança e compliance, implementamos várias camadas de proteção:

Saiba mais sobre segurança e compliance