Credenciais de acesso
As credenciais de acesso são chaves únicas e confidenciais que permitem a identificação e autenticação de quem está consumindo a API. Elas garantem que somente parceiros autorizados possam acessar os serviços oferecidos pela API, protegendo os dados e evitando acessos indevidos.
Como obter suas credenciais Sandbox
Para conseguir as credenciais de sandbox, entre em contato como gerente da sua conta Paytime. Após a confirmação dos dados a equipe de integração fornecerá as chaves necessárias.
As credenciais de acesso são composta por:
Credenciaisintegration-key - (Chave de integração)
authentication-key - (Chave de autenticação)
x-token - (Token)
Cada uma delas tem uma função importante para o funcionamento seguro e correto da API.
Como gerar Chave de Autenticação(authentication-key) e Token(x-token)
Após receber sua Chave de integração(integration-key), acesse a área Gestor no sistema Paytime.
- Vá até o menu "Integração";
- Informe a Chave de integração(integration-key) e clique no botão "Consultar";
- Clique na aba Configurações.
- Na página Configurações de API será exibido os campos com: Autenticação(authentication-key) e Token(x-token), necessários para a autenticação de nossas rotas.
- Agora com acesso a suas credencias você pode realizar a autenticação para acessar as rotas, utilize a documentação Autenticação
Endpoint Ambiente Sandbox
O ambiente Sandbox permite realizar testes sem impactar o ambiente de produção. Para acessar os endpoints no ambiente de sandbox, utilize as URLs base abaixo:
- URL principal: https://api.sandbox.paytime.com.br
- URL secundária: https://api.sandbox.yourmanager.com.br
- Url Smart checkout: https://smart-checkout-dev.bemobi.com/bsc/checkout?code=checkout_token
Endpoint Ambiente de Produção
Para acessar o ambiente de produção, é necessário seguir um processo de homologação. Este processo garante que a integração está funcionando conforme o esperado e é concluído com a ajuda de um analista de integração.
Após a homologação, utilize as URLs base de produção:
- URL principal: https://api.paytime.com.br
- URL secundária: https://api.yourmanager.com.br
- URL Payout: https://banking.paytime.com.br
- URL Smart checkout: https://smartcheckout.pagaragora.com.br/bsc/checkout?code=checkout_token
🎯 Pontos importantes
Após o recebimento da sua chave de integração de produção, é necessário gerar e atualizar os seguintes cabeçalhos HTTP nas requisições realizadas ao ambiente de produção:
integration-key- 🔑 Chave de integração
authentication-key – 🔑 Chave de autenticação
x-token – 🛡️ Token de acesso
Além disso, substitua todos os IDs e parâmetros utilizados no ambiente SANDBOX pelos equivalentes de PRODUÇÃO, garantindo o funcionamento correto da integração.
✅ Pré-requisitos obrigatórios
Para que a integração no ambiente de produção funcione corretamente, certifique-se de que:
📋 Os planos estão cadastrados;
🏢 Os estabelecimentos estão devidamente cadastrados.
Importante:Você deverá salvar as suas chaves de API em local seguro,NÃO COMPARTILHE suas chaves de API com ninguém, nem mesmo nos canais de suporte da Paytime.
Nenhum funcionário da Paytime está autorizado a pedir sua chave de API ou qualquer outro dado sensível.
Updated 2 months ago