Introdução

Esta seção apresenta um guia passo a passo para o cadastro e ativação de estabelecimentos na API Paytime, servindo como complemento à documentação oficial.

📌 Tipos de Estabelecimento

Ao criar um estabelecimento, o campo type pode assumir dois valores:

  • BUSINESS→ Pessoa Jurídica
  • INDIVIDUAL → Pessoa Física

⚠️ Atenção:

  • Para estabelecimentos do tipo BUSINESS, é obrigatório informar o campo birthdate.
  • O CEP informado deve ser válido, não sendo recomendado CEP genérico nem com caracteres especiais.
  • O responsible.email deve ser válido e ativo, pois todas as comunicações sobre atualização e ativação serão enviadas para esse endereço.

📄 O payload deve seguir a padronização descrita na documentação Criar Estabelecimento.

🔄 Fluxo de Cadastro e Ativação

  1. Cadastro inicial

    1. Ao criar o estabelecimento, os status iniciais serão:
      1. "risk": "PENDING"
      2. "status": "RISK_ANALYSIS"
    2. O cadastro é encaminhado automaticamente para o Time de Risco da Paytime.
  2. Análise de risco

    1. O Time de Risco da Paytime avalia os dados enviados.
    2. Após aprovação, o status é atualizado para:
      1. "status": "APPROVED"
  3. Ativação de Gateway

    1. Com o estabelecimento aprovado, é possível realizar a ativação das plataformas/gateways.
    2. Consulte a documentação: 📖 Ativação de Gateway.

📡 Eventos de Atualização

Todas as mudanças de status são notificadas via Webhook:

🧪 Ambiente SANDBOX

No ambiente de testes (SANDBOX), existem regras específicas para que o estabelecimento seja cadastrado e aprovado:

  • O campo phone_number é utilizado para realizar os casos de teste em SANDBOX.
    Consulte o Casos de Teste em Sandbox: (link da página caso de Teste)

👉 Dessa forma, o processo de cadastro fica estruturado em duas etapas .

  1. Cadastro e análise de risco
  2. Ativação do gateway (pós-aprovação) (Consulte a documentação de ativação de Gateway)


Did this page help you?