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ídicaINDIVIDUAL→ 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
-
Cadastro inicial
- Ao criar o estabelecimento, os status iniciais serão:
"risk": "PENDING""status": "RISK_ANALYSIS"
- O cadastro é encaminhado automaticamente para o Time de Risco da Paytime.
- Ao criar o estabelecimento, os status iniciais serão:
-
Análise de risco
- O Time de Risco da Paytime avalia os dados enviados.
- Após aprovação, o status é atualizado para:
"status": "APPROVED"
-
Ativação de Gateway
- Com o estabelecimento aprovado, é possível realizar a ativação das plataformas/gateways.
- Consulte a documentação: 📖 Ativação de Gateway.
📡 Eventos de Atualização
Todas as mudanças de status são notificadas via Webhook:
- Evento: updated-establishment-status
- Para mais detalhes, consulte a documentação: 📖 Webhooks – Paytime
🧪 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 .
- Cadastro e análise de risco
- Ativação do gateway (pós-aprovação) (Consulte a documentação de ativação de Gateway)
Updated 11 months ago
Did this page help you?