Primeiros Passos

Pré-requisitos

Antes de consumir a API, confirme:

• conta ativa na plataforma;
• acesso criado na plataforma com tipo INTEGRATION;
• permissão INTEGRATION_ONLY ativa nesse acesso;
• acesso ao painel para solicitar as chaves;
• wallet operacional cadastrada no perfil;
• wallet operacional aprovada pela plataforma;
• origem do seu sistema definida para chamadas de pagamento.

Sequência recomendada

1. Acesso inicial

O primeiro passo é garantir que o usuário responsável pela integração consiga acessar a plataforma e criar um acesso específico para API, do tipo INTEGRATION, com INTEGRATION_ONLY ativo.

2. Solicitação das chaves

Envie ao suporte:

• identificação do usuário integrador e do acesso de integração;
• domínio ou origem operacional;
• wallet operacional já cadastrada e aprovada;
• necessidade de uso dos fluxos de pagamento.

3. Recebimento das credenciais

As credenciais são enviadas exclusivamente por e-mail. A partir desse momento, o integrador passa a ter responsabilidade direta sobre o armazenamento e o uso seguro desses dados.

4. Habilitação da integração

Com as credenciais recebidas, o acesso de integração passa a operar dentro das regras liberadas para aquele usuário, incluindo domínio autorizado e validações de vínculo com a wallet operacional.

5. Cadastro de customers

Cadastre os customers antes de gerar cobranças que dependem de conciliação por cliente.

6. Geração de cobranças

As cobranças PIX devem ser emitidas já vinculadas ao customer adequado, para preservar rastreabilidade e permitir o tratamento correto do fluxo operacional após o pagamento.

O que precisa estar definido antes do go-live

• responsáveis técnicos pelo ambiente;
• canais de suporte;
• wallet operacional vinculada;
• política de armazenamento seguro de credenciais;
• estratégia de conciliação por customer;
• rotina de resposta a falhas de autenticação e indisponibilidade transitória.