API

Pagamentos como códigopara o seu produto e a sua rotina

Crie lotes, dispare Pix, consulte extrato e receba webhooks de liquidação. A mesma infraestrutura da plataforma, disponível para o seu time de tecnologia.

  • REST e JSON
  • Webhooks assinados
  • Sandbox completo
Criar um lote de pagamentosbash
curl -X POST https://api.unificapay.com.br/v1/batches \
  -H "Authorization: Bearer $UNIFICA_API_KEY" \
  -H "Idempotency-Key: lote-2418" \
  -d '{ "reference": "folha_fornecedores", "items": 1284 }'
Capacidades

O que você pode automatizar

REST e JSON

Padrões previsíveis, erros descritivos e versionamento explícito.

Pagamento em lote

Crie lotes com milhares de itens e acompanhe o status item a item.

Webhooks

Notificações de liquidação, falha e estorno com reenvio automático.

Chaves e escopos

Credenciais por ambiente e escopo mínimo por integração.

Sandbox

Ambiente de homologação para testar antes de ir para produção.

Idempotência

Chave de idempotência para evitar pagamento duplicado em retentativas.

Referência

Endpoints principais

Recursos REST com respostas em JSON, paginação padrão e idempotência nas operações de pagamento.

  • POST/v1/batchesCria um lote de pagamentos
  • GET/v1/batches/{id}Consulta o status do lote
  • POST/v1/pix/paymentsEnvia um Pix avulso
  • GET/v1/statementsLista lançamentos do extrato
  • GET/v1/receipts/{id}Recupera o comprovante
  • POST/v1/webhooksRegistra uma URL de notificação

Do primeiro teste ao primeiro lote em produção

Documentação, sandbox e apoio técnico durante a integração, com acompanhamento nos primeiros ciclos de pagamento.

  • Credenciais de sandbox e produção separadas
  • Retentativa segura com idempotência
  • Webhooks assinados para validação
  • Logs de requisição para auditoria
  • Limites de taxa transparentes
  • Canal técnico direto durante a integração

Sandbox

Ambiente de testes disponível

Webhooks

Status em tempo real

Dúvidas

Perguntas frequentes

Como obtenho as credenciais?+

As chaves são geradas no painel após a abertura da conta, separadas por ambiente.

A API cobre cartões?+

As operações de cartão são liberadas conforme o escopo contratado. Fale com o time comercial.

Existe limite de requisições?+

Sim, com limites por chave e por ambiente, informados na documentação técnica.

Consigo testar sem conta ativa?+

O acesso ao sandbox é liberado durante o processo comercial de integração.

Pronto pra parar de conferir pagamento um por um?

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