Introdução à API Selectwin

#Visão Geral

A Selectwin API foi desenvolvida seguindo os melhores padrões REST, proporcionando uma integração simples e eficiente para qualquer aplicação. As operações são realizadas por meio de requisições aos endpoints, utilizando os verbos HTTP apropriados e corpos de mensagem no formato JSON. As respostas são facilmente interpretadas por meio dos códigos de status HTTP, garantindo uma experiência de integração clara e intuitiva, independentemente da linguagem de programação escolhida.

#URLs Base

#Versionamento

O versionamento está incorporado na URL base (/v1), garantindo que mudanças futuras na API não afetem integrações existentes. Quando uma nova versão for lançada, forneceremos documentação atualizada e um período de transição adequado.

#Ambiente Sandbox

Para facilitar o desenvolvimento e testes, a Selectwin disponibiliza um ambiente sandbox (ambiente de testes) que simula as operações do ambiente de produção, sem realizar transações reais ou modificar dados em produção.

#Características do Sandbox

• Os endpoints de operação (clientes, cartões, transações, assinaturas, produtos, webhooks…) funcionam como em produção
• Os recursos de conta (apps e integrações, pixels, área de membros, marketplace, encerramento) são só leitura em sandbox: altere-os em produção. Uma escrita neles com a chave sk_test_ responde 409 accountLevelReadOnlyInSandbox
• Simula os comportamentos de sucesso e falha das operações
• Permite testar fluxos completos de transações, do início ao fim
• Não realiza cobranças reais em cartões de crédito
• Não afeta o ambiente de produção

#Como Utilizar o Sandbox

A principal diferença entre os ambientes de sandbox e produção está na chave de API (SelectKey) utilizada. Para utilizar o ambiente sandbox, basta incluir uma chave de teste no cabeçalho das requisições:

curl -X POST "https://api.selectwin.io/v1/transactions" \
     -H "SelectKey: sk_test_1234567890abcdefghijklmn" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -d '{
       "amount": 10000,
       // ... outros parâmetros
     }'

#Simulação de Cenários

O ambiente sandbox permite simular diversos cenários para testar a robustez da sua aplicação:

• Transações Aprovadas: Para testar fluxos de sucesso
• Transações Recusadas: Para testar tratamento de erros
• Estornos e Cancelamentos: Para testar fluxos de devolução
• Chargebacks: Para testar disputas e contestações
• Notificações via Webhook: Para testar sua infraestrutura de recebimento de notificações

#Migrando para Produção

Quando sua integração estiver completa e testada no ambiente sandbox, a migração para produção é simples - basta substituir a chave de teste pela chave de produção em suas requisições:

# Ambiente de sandbox
SelectKey: sk_test_1234567890abcdefghijklmn

# Ambiente de produção
SelectKey: sk_live_1234567890abcdefghijklmn

Recomendamos configurar sua aplicação para utilizar diferentes chaves dependendo do ambiente (desenvolvimento, teste, produção), facilitando a migração entre ambientes sem alterações de código.

#Suporte à Integração

Durante o processo de integração, disponibilizamos suporte técnico especializado para auxiliar no desenvolvimento e na resolução de problemas:

• Documentação: Este guia completo com exemplos práticos
• Ambiente de Sandbox: Para testes sem custos ou riscos
• Suporte Técnico: Via e-mail em help@selectwin.io
• FAQ: Respostas para as perguntas mais frequentes
• Tutoriais: Passo a passo para implementações comuns

Para obter suas credenciais de sandbox, acesse o painel administrativo da Selectwin ou entre em contato com nossa equipe de suporte.