Começando
Ambientes e chaves
Uma URL só; o ambiente vem do prefixo da chave.
Sandbox e produção
| Ambiente | Prefixo da chave | Para quê |
|---|---|---|
| Sandbox | yp_test_ | Desenvolver e testar. Nada é cobrado de verdade. |
| Produção | yp_live_ | Vendas reais. |
A URL é a mesma nos dois: https://yuupe.me/api/v1/pay. Pedidos, webhooks e chaves de um ambiente não aparecem no outro. Cada resposta traz ambiente, para o seu log.
Gerar e revogar chaves
- Em Yuupe Pay › Integração, no painel da Yuupe. A chave aparece uma única vez; a Yuupe guarda só uma assinatura dela.
- Pode haver mais de uma chave ativa por ambiente (por exemplo, uma por servidor). Revogar uma não afeta as outras.
- Chave revogada responde
401 chave_revogadana hora.
Nunca no navegador
A chave cobra em nome da loja. Ela fica só no servidor. No navegador vai apenas a chave pública do pay.js, que serve só para gerar o token do cartão.
Limitações do sandbox
- Split: não é aplicado no sandbox (limitação da operadora). Em produção, a divisão sai na própria cobrança.
- Cartão com 3DS: no sandbox o valor mínimo do cartão é R$ 600,00 e a confirmação do banco nem sempre está ligada. Teste o token, a chamada e o tratamento dos status; a prova completa do cartão é feita em produção, com a Yuupe.
- Cartão que aprova no sandbox:
5555 5555 5555 5557(Mastercard, validade futura e qualquer CVV). Outros números são recusados, o que serve para testar a recusa.