Onde pego as chaves de API e como testo no sandbox?

As chaves de API ficam em Configurações → Desenvolvedores, na tabela Chaves de API. Cada chave pertence a um ambiente: as de Sandbox começam com sk_test_ e as de Produção, com sk_live_.

Gerar uma chave

1. No topo do painel, ao lado do logo, escolha Produção ou Sandbox. A chave nasce no ambiente em que o painel está.
2. Vá em Configurações → Desenvolvedores e clique em Gerar chave.
3. Preencha a Descrição (por exemplo, "ERP") e, se quiser, uma data em Expira em.
4. Em Acesso, escolha Total (tudo o que você pode) ou Restrita (só o que marcar). Na restrita, defina para cada recurso Nada, Ler ou Tudo.
5. Clique em Gerar chave e confirme a sua identidade quando o painel pedir.
6. Copie a chave na hora: ela aparece inteira uma vez só.

Envie a chave secreta no cabeçalho SelectKey, sempre a partir do seu servidor, e não no seu site ou app — veja como autenticar. Na mesma tabela, abaixo do identificador da chave, aparece também a chave publicável (pk_), com o botão de copiar. Ela pode ir ao navegador: só identifica a sua conta para o cartão ser tokenizado na página.

1234

1. 1Gerar chave: descrição, validade e Acesso (Total ou Restrita).
2. 2A chave secreta (sk_live_ em Produção, sk_test_ no Sandbox).
3. 3A chave publicável (pk_), com o botão de copiar.
4. 4Revogar desliga a chave na hora.

Se uma chave vazar, use Revogar: ela para de funcionar na hora. Só o Proprietário gera chaves; o Administrador vê a lista e revoga. Se não conseguir gerar, ou não vê a página Desenvolvedores, peça ao Proprietário da conta.

Testar no Sandbox

• A URL da API é a mesma nos dois ambientes, https://api.selectwin.io. Quem decide o ambiente é a chave.
• No Sandbox não há cobrança real. Os cartões de teste, cada um com um resultado diferente, estão na documentação da API.
• O que nasce no Sandbox fica no Sandbox: um link de pagamento de teste não abre como cobrança real, e um webhook cadastrado com o painel em Sandbox recebe só eventos de teste.
• As automações do SmartOps não disparam para vendas de teste.

Ir para produção

Gere uma chave com o painel em Produção, troque a sk_test_ pela sk_live_ no seu sistema e cadastre também em Produção os webhooks de que precisa — veja como configurar webhooks.