ℹ️

Antes de usar este endpoint, recomendamos fortemente que você leia:

• Criar subconta - campos, obrigatoriedade, limites e exemplos de requisição por bloco (dados cadastrais, bancários, sobretaxa e frequência de repasse).
• Configuração de sobretaxa - quem paga a taxa da Safe2Pay e recebe a NFS-e, os tipos de taxa aceitos em cada meio de pagamento, as regras de Repasse, Nota Fiscal de Serviço, SMS e Antifraude, e o que a validação recusa.

Esses pontos definem como a configuração de taxas da subconta é gravada e evitam as recusas mais comuns na integração.

❗️

IMPORTANTE

• Token de autenticação
  • O Token de autenticação para integração é retornado apenas no momento da criação da subconta;
  • Em caso de perda do Token, é preciso acionar o time de suporte para criação de um novo Token.
• O objeto BankData deve ser sempre informado por completo.
• O objeto MerchantSplit é opcional. Se você informá-lo, informe a configuração completa: os meios de pagamento e serviços que não estiverem no array não serão configurados para a subconta. Se não informá-lo, a subconta é criada apenas com a taxa de repasse padrão.

ℹ️

Suporte a CNPJ alfanumérico

A Receita Federal iniciará a emissão de CNPJs alfanuméricos a partir de julho de 2026. Essa mudança se aplica exclusivamente a novas inscrições, não havendo alterações nos CNPJs já existentes.

A Safe2Pay estará apta a processar e receber CNPJs alfanuméricos a partir da entrada em vigor dessa mudança, incluindo integrações com adquirentes que suportam esse formato, como a Cielo.

Não serão necessárias alterações na integração da API da Safe2Pay.

Recomendamos, no entanto, que integradores e estabelecimentos revisem seus sistemas próprios (checkout, ERP, antifraude e validações cadastrais) para garantir compatibilidade com o novo padrão, especialmente para:

• Aceitar caracteres alfanuméricos nos campos de CNPJ;
• Evitar validações restritas apenas a números;
• Revisar máscaras e expressões regulares utilizadas na validação do documento.