Winner Pay LogoWinner PayAPI Reference

INTRODUÇÃO

PIX

WEBHOOK

OUTROS

INTEGRAÇÃO

Powered byWinner Pay

Começando

Sistema de Pagamentos e Transferências PIX. Toda a documentação relacionada a transações e pagamentos.

🔗 Integração com Adquirentes

O Winner Pay atua como uma camada intermediária que integra com múltiplas adquirentes de pagamento. Quando você cria uma transação PIX, o sistema:

  1. Busca a adquirente ativa configurada no sistema
  2. Cria a transação internamente no Winner Pay
  3. Chama a API da adquirente ativa para processar o pagamento
  4. Retorna os dados do QR Code/cobrança para o checkout
  5. Recebe notificações via webhook da adquirente
  6. NORMALIZA os webhooks para um formato único e padronizado
  7. Envia webhook normalizado para seu endpoint configurado
  8. Atualiza o status da transação automaticamente

Importante: O checkout NÃO precisa conhecer qual adquirente está sendo usada. Todos os webhooks que você receberá seguem o MESMO formato independente da adquirente.

Você pode trocar de adquirente a qualquer momento SEM precisar alterar seu código!

✅ Guia Rápido

Use estes endpoints no checkout/integrador externo:

  1. Autenticação (Client Credentials)
    Authorization: Basic {base64(client_id:client_secret)} ou X-Client-Id/X-Client-Secret
  2. Seller (dados da empresa do dono das credenciais)
    GET /api/seller
  3. Cash-in (gerar QR Code PIX)
    POST /api/financial/receber-pix
    Retorno inclui: qr_code_data e pix_copia_e_cola
  4. Webhooks (status padronizado, independente da adquirente)
    Envie "postbackUrl" no criar PIX para receber notificações
  5. Consultas
    GET /api/financial/transactions (paginado)
  6. Cash-out (transferência PIX)
    POST /api/financial/transferencia-pix

⚠️ Observação importante: A seção "Criar Transação (DASHBOARD)" é de uso interno do painel WinnerPay e não deve ser usada no checkout externo.

Base URL

https://api.winnerpayy.com.br/api