Ajuda · API

APIpasso a passo e artigos de uso

Autenticação, ambiente de testes, principais endpoints, webhooks e boas práticas de idempotência.

Onboarding

Como começar em quatro etapas

  1. 01

    Acesso ao sandbox

    Solicite as credenciais de teste e valide a autenticação.

  2. 02

    Primeira chamada

    Consulte saldo e extrato para confirmar que o token está funcionando.

  3. 03

    Webhooks

    Cadastre a URL de callback e valide a assinatura das notificações.

  4. 04

    Produção

    Após os testes aprovados, troque as credenciais e libere o tráfego real gradualmente.

Autenticação e credenciais

Como gerar e rotacionar chaves.

Cada ambiente tem credenciais próprias. Guarde as chaves em cofre de segredos e rotacione periodicamente, revogando as antigas pelo painel.

Receber webhooks com segurança

Assinatura, reentrega e idempotência.

Valide a assinatura de cada notificação antes de processar. Como pode haver reentrega, trate os eventos de forma idempotente usando o identificador do evento.

Códigos de erro e reprocessamento

Como interpretar respostas e repetir chamadas.

Erros de validação retornam o campo problemático na resposta. Para falhas temporárias, aplique repetição com espera progressiva e sempre envie a chave de idempotência.

Pronto pra parar de conferir pagamento um por um?

Suba a planilha, a Unifica cuida do resto, do pagamento ao comprovante no seu contador.