Roteiro Homologação - API Transacional

A homologação garante que a integração da sua aplicação com a API Paytime está em conformidade com os padrões de segurança, escalabilidade e boas práticas antes de receber as credenciais de produção.

📅Quando recebo a chave de produção?

Após finalizar os testes e validações no ambiente Sandbox dos produtos a serem integrados, o parceiro poderá solicitar a homologação. Após a aprovação, a chave de integração para o ambiente de produção será disponibilizada.

📋Como devo encaminhar o roteiro de homologação?


O roteiro de homologação pode ser enviado de duas formas:

  • Completo: contendo todas as APIs e funcionalidades que serão utilizadas na integração;
  • Incremental: à medida que cada funcionalidade for sendo implementada e validada pelo parceiro.

🆕Quando devo encaminhar o novo roteiro de homologação?


Mesmo que seu ambiente já possua credenciais de produção ativas e acesso homologado para determinadas APIs, sempre que houver a implementação de novas funcionalidades ou utilização de novas APIs da Paytime, será necessário encaminhar um novo roteiro de homologação referente aos recursos adicionados. Isso garante que as novas integrações sejam validadas e aprovadas antes de sua utilização em ambiente produtivo.

Como funciona a homologação

Para homologar um produto junto à Paytime é necessário realizar os testes diretamente na sua aplicação, onde seu usuário/cliente irá interagir. Ou seja, não serão aceitos testes realizados pelo Postman, Swagger ou qualquer outra plataforma que permita simulação de requisições e retornos.

As evidências devem ser colocadas no roteiro de homologação do produto contratado e enviadas em PDF para o o time de homologação, o título do envio deve seguir o formato: Solicitação de Homologação CNPJ: Informe o seu CNPJ, para o email [email protected]

🔽 Baixe aqui o modelo para responder os dados abaixo.

Dados obrigatórios:

DADOS DO PARCEIRO

Razão Social:
CNPJ:
Nome do responsável pela integração:
Email de contato:

Produtos a serem homologados:
Marque quais dos produtos esta homologando.

Transações

[ ] PIX
[ ] - Criar
[ ] - Listagem
[ ] Crédito
[ ] - Criar
[ ] - Listagem


Boleto
[ ] - Criar
[ ] - Listagem

Estabelecimentos

[ ] - Criar
[ ] - Listagem

Uso de antifraude

[ ] IDPAY
Informe o domínio do seu site que irá utilizar o SDK IDPAY: https://SEU_DOMINIO
[ ] 3DS

Perguntas sobre o fluxo de implementação

Responda as perguntas abaixo:
Visão geral da integração:
Descreva o fluxo geral de integração entre o seu sistema e a API da Paytime.
Como a sua aplicação está estruturada (arquitetura, fluxos de dados) e como os endpoints da Paytime são consumidos?


Endpoints utilizados:
Quais endpoints da API da Paytime estão sendo chamados na sua aplicação?
Forneça um diagrama ou fluxo ilustrando como os diferentes endpoints se relacionam com os processos do seu sistema.

Autenticação e segurança:
Como você está gerenciando as credenciais de integração (integration-key, x-token, authentication-key)?
Quais medidas de segurança estão implementadas para garantir a proteção desses dados?
Detalhe como sua aplicação utiliza HTTPS e se implementa algum mecanismo de rate limiting ou controle de acesso.

Como enviar os testes para homologação?

Para que o time de integração possa analisar o roteiro de homologação e validar o fluxo de implementação acima, solicitamos que sejam enviadas as evidências abaixo listadas para o email: [email protected].

Evidências a serem enviadas por tipo de produto

Para todos os endpoints utilizados evidenciar com:
Código e Headers: Envie imagens com trechos de código demonstrando as chamadas à API, com especial atenção à inclusão dos Headers contendo as credenciais (integration-key, x-token, Bearer Token).
IDs de transações aprovadas e reprovadas.

Como enviar?

Em um mesmo arquivo, inclua as respostas das perguntas e as evidências, converta o arquivo em PDF e encaminhe para o email: [email protected], com o assunto: Solicitação de Homologação - CNPJ: [Informe o cnpj].

Prazo do retorno

Até 5 dias úteis após envio do roteiro preenchido, a contar a partir do dia útil subsequente ao envio.


Did this page help you?