Visão geral

O SDK oficial da Selectwin para Python — pagamentos (cartão, Pix, boleto), assinaturas e webhooks, com clientes síncrono e assíncrono, tipagem e ergonomia de produção.

O pacote selectwin combina um núcleo gerado (via openapi-python-client, sobre httpx) com uma casca de DX escrita à mão: clientes sync/async, erros tipados, retries automáticos, idempotência, paginação e verificação de assinatura de webhook. Requer Python 3.9+.

Destaques

• Sync e async — Selectwin(...) e AsyncSelectwin(...), mesma superfície.
• Namespaces por recurso — sw.transactions.create(...), sw.customers.list(...), sw.subscriptions.pause(...).
• Erros tipados — CardError, ValidationError, RateLimitError, AuthenticationError, …
• Idempotência automática em mutações + retries com backoff em 429/5xx/rede.
• Paginação — itere direto: for tx in sw.transactions.list(limit=100).
• Webhooks — construct_event(...) valida o HMAC e devolve um evento tipado.

Exemplo rápido

import os
from selectwin import Selectwin

sw = Selectwin(api_key=os.environ["SELECTWIN_API_KEY"])

tx = sw.transactions.create({
    "amount": 5000,  # centavos = R$ 50,00
    "payment": {"method": "pix", "currency": "BRL"},
    "customer": {
        "firstName": "João",
        "lastName": "Silva",
        "email": "[email protected]",
        "document": {"type": "cpf", "number": "12345678901"},
    },
})

print(tx.id, tx.status)  # tra_… pending

Próximos passos

• Instalação — instalar e configurar o cliente.
• Quickstart — cobrança, erros, paginação, async e webhooks.
• Referência da API — todos os endpoints e modelos.

Código-fonte no GitHub · pacote no PyPI.