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 todas as funcionalidades do ambiente de produção, sem realizar transações reais ou modificar dados em produção.

Características do Sandbox

• Totalmente funcional, com todos os endpoints disponíveis
• 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: sl_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: sl_test_1234567890abcdefghijklmn

# Ambiente de produção
SelectKey: sl_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 [email protected]
• 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.