Integração da Nova API da Stone para Clientes Vindi

Este é um documento temporário, que auxilia os clientes Vindi a localizarem suporte sobre a nova diretriz de atualização de API indicada pela Adquirente Stone. Este documento tem vigência até 30/06 ou até que a migração dos clientes tenha sido finalizada.

1. O que é a nova API da Stone?

API RESTful para operações de pagamento com troca em JSON.

2. Quais operações estão disponíveis na nova API?

Autorizar, capturar, cancelar, estornar e consultar transações.

3. Como acessar o ambiente de homologação?

Enviar e-mail para [email protected] com dados da empresa.

4. Quais são as URLs de Produção e Homologação?

Produção - https://e-commerce.stone.com.br | Homologação - https://sandbox-auth-integration.stone.com.br

5. Como faço a autenticação na API?

Basic Auth com SecretKey no usuário e senha em branco.

6. Quais são os pré-requisitos para integração?

Pedir chaves de integração para o gerente de contas da Stone Online ou ou realizar via Portal Stone Web e pedir a integração para o time de credenciamento Vindi pelo email credenciamento@vindi.com.br

7. Qual é o processo de integração?

Instruções ao Cliente para a Integração com a Vindi:

• Geração da Chave SK Stone:
  
  
  • Acesse o Portal Stone Web e gere uma nova chave de acesso.Stone
    
    
• Envio da Chave para a Vindi:
  
  
  • Após gerar a chave, encaminhe-a para nossa equipe de suporte ou diretamente para o seu gerente de conta na Vindi pelo email credenciamento@vindi.com.br
  • .
    
    
• Configuração na Plataforma Vindi:
  
  
  • Nossa equipe realizará a configuração necessária para integrar a nova chave à sua conta na Vindi.
    
    

Nota: Neste novo fluxo, os tokens de acesso não serão utilizados.

8. Estou com uma integração em andamento, o que fazer?

Os clientes em etapa de integração até 30/06 precisarão entrar em contato com a Stone, para solicitar uma nova chave de acesso e migrar para a nova integração ou realizar via Portal Stone Web.

9. Como realizar a captura de transações?

Pode ser imediata ou até 7 dias após autorização.

10. Como cancelar uma transação?

Cancelamento via API; estorno pós-captura via POS ou portal.

11. A API suporta pagamentos parcelados?

Sim, a API permite configurar parcelamentos conforme regras da Stone.

12. Como tratar erros e mensagens de retorno da API?

A API retorna códigos HTTP e mensagens JSON detalhadas para tratamento.

13. É possível consultar o status de uma transação via API?

Sim, há endpoints específicos para consulta detalhada.

15. A API da Stone suporta pagamentos com cartão virtual?

Sim, cartões virtuais são aceitos desde que compatíveis com bandeira.

17. Como garantir a segurança dos dados transmitidos?

A API utiliza HTTPS e autenticação segura com SecretKey.

18. Existe um limite de requisições por minuto na API?

Sim, a Stone aplica rate limiting para evitar abusos; consulte suporte para detalhes.

19. Posso usar a mesma SecretKey para ambientes de homologação e produção?

Não, cada ambiente tem suas próprias credenciais.

20. Como integrar a Stone com o sistema de cobranças da Vindi?

Utilizando os webhooks da Vindi para sincronizar eventos de pagamento com a API Stone.

21. Quais cuidados devo ter ao migrar do sistema antigo para a nova API?

Realizar testes completos em homologação, validar dados de transações, configurar corretamente autenticação e monitorar logs na fase inicial de produção.

22. Como vejo meu Stone Code?

Dentro do Portal Stone Web você consegue visualizar seu Stone Code.

23. Minhas transações serão tokenizadas?

Sim, caso você utilize o nosso produto Renova Cartões, contratando diretamente com seu gerente de contas Vindi.