Saltar para o conteúdo
Constaia
payment_receipt

Comprovativo de pagamento ou transferência bancária

O montante, o IBAN de destino e a referência da inscrição coincidem?

Categoria
Pagamentos e finanças
País
Internacional
Campos extraídos
9 campos
Custo
1 crédito
Comprovativo de transferência
Rever
EspécimeExperimente na demo

Os comprovativos chegam como PDF, capturas de ecrã ou fotografias. A Constaia extrai montante, data, ordenante, beneficiário, IBAN e descritivo, valida o IBAN e verifica que coincide com o que esperava.

  • Um comprovativo não prova que o dinheiro chegou: concilie sempre com o seu extrato bancário.
  • Os avisos edited_suspected e screen_photo_suspected são indícios, não provas.

O que verifica

  • IBAN. Dígitos de controlo ISO 13616 e comprimento por país.
  • Valores esperados. Montante, referência ou IBAN coincidem com os indicados.
  • Titular. Nome, número ou data de nascimento coincidem com o esperado.

Campos extraídos

  • Montanteamount
  • Moedacurrency
  • Datadate
  • Ordenantepayer_name
  • IBAN do ordenantepayer_iban
  • Beneficiáriobeneficiary_name
  • IBAN do beneficiáriobeneficiary_iban
  • Descritivoconcept
  • Referênciareference

Onde se usa

Exemplo de pedido

curl https://api.constaia.com/v1/analyze \
  -H "Authorization: Bearer $CONSTAIA_API_KEY" \
  -F "file=@document.pdf" \
  -F 'options={
    "expect": "payment_receipt",
    "checks": {
      "expected_amount": 45,
      "expected_iban": "ES9121000418450200051332",
      "expected_reference": "INS-2026-0183"
    },
    "storage": "none"
  }'

Exemplo de resposta

Dados fictícios. Resposta abreviada.

200 OK · application/json
{
  "id": "an_01J9Z3K8QW4T6Y2B7N5M1R0PXC",
  "object": "analysis",
  "status": "completed",
  "livemode": false,
  "document": {
    "type": "payment_receipt",
    "label": "Comprovativo de pagamento ou transferência bancária",
    "confidence": 0.97
  },
  "verdict": {
    "expected": [
      "payment_receipt"
    ],
    "match": true,
    "status": "valid",
    "reasons": [
      {
        "code": "type_match",
        "severity": "info",
        "message": "O documento é: Comprovativo de pagamento ou transferência bancária."
      }
    ]
  },
  "fields": {
    "amount": {
      "value": 45,
      "confidence": 0.99,
      "validated": true
    },
    "currency": {
      "value": "EUR",
      "confidence": 0.98,
      "validated": null
    },
    "date": {
      "value": "2026-09-27",
      "confidence": 0.97,
      "validated": null
    },
    "payer_name": {
      "value": "LAURA MARTIN RUIZ",
      "confidence": 0.96,
      "validated": null
    },
    "beneficiary_name": {
      "value": "CLUB DEPORTIVO EJEMPLO",
      "confidence": 0.99,
      "validated": null
    },
    "beneficiary_iban": {
      "value": "ES9121000418450200051332",
      "confidence": 0.98,
      "validated": null
    },
    "concept": {
      "value": "INS-2026-0183 Trail",
      "confidence": 0.97,
      "validated": null
    },
    "reference": {
      "value": "INS-2026-0183",
      "confidence": 0.96,
      "validated": null
    }
  },
  "checks": [
    {
      "code": "iban_check_digits",
      "passed": true,
      "message": "Os dígitos de controlo do IBAN estão corretos."
    },
    {
      "code": "expected_amount",
      "passed": true,
      "message": "O montante coincide com o esperado."
    },
    {
      "code": "expected_reference",
      "passed": true,
      "message": "A referência coincide com a esperada."
    }
  ],
  "warnings": [],
  "storage": {
    "mode": "none",
    "file_deleted_at": "2026-09-29T10:00:02Z",
    "expires_at": null
  },
  "usage": {
    "credits": 1,
    "pages": 1
  }
}

FAQ

A Constaia prova que o documento é autêntico?

Não. Verifica o tipo, a coerência dos dados e as suas regras, e assinala sinais como possível edição ou fotografia de ecrã. Isso não prova autenticidade.

É guardada uma cópia do documento?

Não, a menos que o peça. Com storage "none" (por omissão) o ficheiro é apagado quando a análise termina.

Outros documentos

E para que conste…

Crie a sua conta, copie a chave de teste e valide o seu primeiro documento em cinco minutos.