Documentação da API de pagamentos da Selectwin

Tudo o que você precisa para cobrar com Pix, cartão e boleto — em um lugar só, com exemplos prontos para copiar e colar. A API da Selectwin (api.selectwin.io) coloca todo o fluxo de dinheiro no piloto automático: cobrança, conciliação, split de receita, recebíveis e saque, com a confiabilidade que uma fintech exige e a clareza que um desenvolvedor merece.

Esta é a porta de entrada da plataforma — e ela foi escrita para dois públicos. Se você vai escrever o código, comece pela trilha de desenvolvedores: autenticação, quickstart e referência. Se você vai decidir o que construir, vá para a trilha de negócios: checkout, Pix, split, recorrência e conciliação, com a robustez fintech por trás de cada centavo.

Para desenvolvedores

Uma API REST previsível: você fala JSON, autentica por cabeçalho e interpreta o resultado pelos códigos de status HTTP. Sem OAuth, sem handshake, sem fricção — qualquer linguagem ou stack funciona direto.

Quickstart

Sua primeira cobrança segue o padrão que você já conhece de uma API moderna: autentique, crie uma transação, escute o webhook.

No painel da Selectwin, em Desenvolvedores → Chaves de API, copie sua chave de sandbox (sl_test_…). Toda requisição é autenticada pelo cabeçalho selectkey — sem tokens de sessão para renovar.

Crie uma cobrança Pix de R$ 1.499,00. O campo amount é o total em centavos (mínimo R$ 5,00) e fica no topo do corpo; o meio de pagamento (pix) e a moeda vão dentro do objeto payment.

<Tabs items={['curl', 'Node.js', 'Python']}>

const transaction = await res.json(); console.log(transaction.id, transaction.status);

</Tab>

<Tab value="Python">
```python
import os, requests

res = requests.post(
    "https://api.selectwin.io/v1/transactions",
    headers={"selectkey": os.environ["SELECTWIN_API_KEY"]},
    json={
        "amount": 149900,
        "payment": {
            "method": "pix",
            "currency": "BRL",
            "pix": {"expiresInMinutes": 30},
        },
    },
)

transaction = res.json()
print(transaction["id"], transaction["status"])

Você não fica fazendo polling para saber se o comprador pagou o Pix ou o boleto. Cadastre um endpoint em /v1/webhooks/endpoints e a Selectwin avisa o seu servidor quando o pagamento for aprovado — com payload assinado em HMAC-SHA256 e histórico completo de entregas para reprocessar.

{
  "event": "transaction.approved",
  "data": {
    "id": "tx_3a9f...",
    "status": "approved",
    "amount": 149900,
    "payment": {
      "method": "pix",
      "currency": "BRL"
    }
  }
}

Troque sl_test_… por sl_live_…. Só isso. Mesma URL base, mesmos contratos, mesmos webhooks — o ambiente de testes é fiel ao de produção, então o que funciona no sandbox funciona valendo.

Autenticação em poucas palavras

Toda requisição autenticada envia sua chave no cabeçalho selectkey. O prefixo da chave indica o ambiente: sl_test_… em sandbox e sl_live_… em produção. Não há tokens de sessão para renovar nem fluxo de autorização para implementar.

<TypeTable type={{ selectkey: { description: 'Sua chave de API. Use sl_test_… em sandbox e sl_live_… em produção.', type: 'string (header)', required: true, }, 'Content-Type': { description: 'application/json em qualquer requisição com corpo.', type: 'string (header)', required: false, }, }} />

Para o seu negócio

A mesma API cobre o funil financeiro inteiro — do primeiro clique do comprador à liquidação na sua conta. Você não precisa de sete ferramentas soltas: checkout, Pix, split de receita, recorrência, conciliação e saque saem da mesma plataforma, com endpoints reais e documentados.

O que você pode construir

Cada recurso abaixo tem endpoints reais na Referência da API. Some-os e você tem uma operação financeira completa, sem precisar virar uma fintech para vender como uma.

Construída como infraestrutura financeira

Confiança não é um detalhe de marketing — é arquitetura. Cada chamada à API da Selectwin herda as mesmas garantias, e é por isso que o negócio pode escalar sem medo do operacional financeiro.

• Anti-cobrança-dupla nativa — travas de concorrência por sessão e jobs de pagamento idempotentes garantem que um retry de rede ou um clique nervoso nunca virem duas cobranças.
• Webhooks assinados (HMAC-SHA256) — com arquivo completo de eventos, diagnóstico de entregas e replay manual.
• Precisão de centavo — em split, estorno, recebível e saldo, em qualquer volume.
• Saldo real em uma chamada — disponível, pendente e bloqueado, separados e auditáveis em /v1/finance/balance.
• O Brasil como cidadão de primeira classe — Pix, boleto e cartão parcelado não são "métodos locais bolt-on"; são o centro do produto.

Recursos da API por área

A Referência da API é organizada por recurso — cada um com seus endpoints, schemas de requisição/resposta e exemplos executáveis no playground "Try it".

Perguntas frequentes

Próximo passo

Pegue sua API key, rode o Quickstart e veja sua primeira cobrança aprovada em minutos — sem mensalidade, sem setup, no ambiente de testes.

Selectwin — a infraestrutura de receita da nova fintech brasileira. Pix, cartão e boleto com a clareza que o desenvolvedor merece e a robustez que o negócio exige.