Unifica Pay
Documentação

Erros e limitescom exemplos prontos para copiar

Erros seguem um formato único com código legível por máquina. Limites de uso são informados nos headers de cada resposta.

O que você precisa saber

  • Limite padrão de 120 requisições por minuto por chave, com headers X-RateLimit-*.
  • Erros 5xx e 429 podem ser repetidos com backoff, sempre reutilizando a mesma Idempotency-Key.
  • Erros 4xx indicam problema no payload e não devem ser repetidos sem correção.
POST/v1/batches

Exemplo de erro de validação

Payload inválido devolve 422 com a lista de campos problemáticos.

Request, cURLbash
curl -X POST https://api.unificapay.com.br/v1/batches \
  -H "Authorization: Bearer sk_live_9a71..." \
  -H "Content-Type: application/json" \
  -d '{ "payments": [ { "amount": 0 } ] }'
Response, 422 Unprocessable Entityjson
{
  "error": {
    "code": "validation_error",
    "message": "Nao foi possivel criar o lote",
    "details": [
      { "field": "payments[0].amount", "message": "Deve ser maior que zero" },
      { "field": "payments[0].pix_key", "message": "Campo obrigatorio" }
    ],
    "request_id": "req_0e91cb"
  }
}

Continue explorando

Primeiros passos

Ambientes, chaves e sua primeira chamada autenticada.

Abrir

Autenticação

Chaves de API, escopos e rotação segura.

Abrir

Pagamentos em lote

Criação de lotes, idempotência e acompanhamento de status.

Abrir

Conciliação e comprovantes

Extrato conciliado e download de comprovantes em PDF.

Abrir

Webhooks

Eventos em tempo real com assinatura HMAC.

Abrir