Python
Instalação
Instale o pacote selectwin com pip (ou seu gerenciador preferido). Requer Python 3.9+. As dependências são enxutas: httpx + attrs.
Instale o pacote selectwin com pip (ou seu gerenciador preferido). Requer Python 3.9+. As dependências são enxutas: httpx + attrs.
Instalar
pip install selectwin
# poetry add selectwin · uv add selectwin · pdm add selectwinConfigurar o cliente
Toda requisição autentica com sua SelectKey no header SelectKey. Use sk_test_… no sandbox e sk_live_… em produção — o ambiente é resolvido pela própria chave. Guarde-a como variável de ambiente; nunca a exponha no cliente.
import os
from selectwin import Selectwin
sw = Selectwin(api_key=os.environ["SELECTWIN_API_KEY"])O cliente pode ser usado como context manager (fecha as conexões ao final):
with Selectwin(api_key=os.environ["SELECTWIN_API_KEY"]) as sw:
tx = sw.transactions.create({ "amount": 5000, "payment": {"method": "pix", "currency": "BRL"}, "customer": {"id": "cus_…"} })
# ou chame sw.close() manualmenteAsync
import asyncio
from selectwin import AsyncSelectwin
async def main():
async with AsyncSelectwin(api_key=os.environ["SELECTWIN_API_KEY"]) as sw:
tx = await sw.transactions.create({ "amount": 5000, "payment": {"method": "pix", "currency": "BRL"}, "customer": {"id": "cus_…"} })
print(tx.id, tx.status)
asyncio.run(main())Opções
sw = Selectwin(
api_key=os.environ["SELECTWIN_API_KEY"],
base_url="https://api.selectwin.io", # sobrescreva para mock/staging
max_retries=2, # 429/5xx/rede (padrão 2)
timeout=60.0, # segundos (padrão 60)
)Próximos passos
- Quickstart — sua primeira cobrança em minutos.
How is this guide?