Quickstart
Sua primeira cobrança em poucos minutos. Você vai: autenticar, criar uma transação PIX, e receber a confirmação por webhook.
1. Obtenha sua chave
No Painel Administrativo, com o seletor de ambiente em Sandbox, abra Configurações → Desenvolvedores e, em Chaves de API, clique em Gerar chave. A chave aparece inteira uma vez só: copie nesse momento.
- Sandbox:
sk_test_...· Produção:sk_live_...
Toda requisição envia a chave no header SelectKey. Guarde-a como variável de ambiente. Acesso Total ou Restrita,
validade e chave publicável: Autenticação.
2. Faça sua primeira chamada
Liste transações (deve retornar uma lista paginada vazia ou existente):
curl "https://api.selectwin.io/v1/transactions" \
-H "SelectKey: sk_test_aBcDeFgHiJkLmNoPqRsTuVwXyZ"3. Crie uma transação (PIX)
Valores são inteiros em centavos (5000 = R$ 50,00):
curl -X POST "https://api.selectwin.io/v1/transactions" \
-H "SelectKey: sk_test_aBcDeFgHiJkLmNoPqRsTuVwXyZ" \
-H "Content-Type: application/json" \
-H "X-Idempotency-Key: 2dfc6a63-5df5-4900-baca-e49d91ef393e" \
-d '{
"amount": 5000,
"currency": "BRL",
"externalReference": "PEDIDO-1001",
"customer": {
"firstName": "João",
"lastName": "Silva",
"email": "joao@example.com",
"document": { "type": "cpf", "number": "12345678901" }
},
"payment": { "method": "pix" }
}'Resposta (resumida):
{
"id": "tra_01hqzvabc",
"status": "pending",
"amount": 5000,
"method": "pix",
"currency": "BRL"
}4. Receba a confirmação por webhook
Registre um endpoint para ouvir os eventos de transação:
curl -X POST "https://api.selectwin.io/v1/webhooks" \
-H "SelectKey: sk_test_aBcDeFgHiJkLmNoPqRsTuVwXyZ" \
-H "Content-Type: application/json" \
-d '{
"name": "Minha loja",
"endpoint": "https://minhaloja.com/webhooks/selectwin",
"events": ["transaction.approved", "transaction.failed"]
}'A resposta traz um secret (whsec_...) — guarde-o para verificar a assinatura das entregas.
Quando o pagamento for confirmado, seu endpoint recebe:
{
"id": "wbh_01hqzvabc",
"type": "transaction.approved",
"source": "automatic",
"payload": {
"object": { "id": "tra_01hqzvabc", "status": "approved", "amount": 5000 }
},
"createdAt": "2026-04-12T17:56:33.000Z"
}Próximos passos
- Convenções — centavos, datas, IDs opacos
- Cartões de teste — para testar crédito no sandbox
- Transações — crédito, captura, estorno, disputa
- Tratamento de Erros + Catálogo de Códigos
- Idempotência — repita requisições com segurança
Atualizado em 17 de outubro de 2026