ProofRails logoProofRails Docs
Evidence layer for onchain payments

Verify a receipt

Official documentation for ProofRails — the open evidence and translation layer for onchain payments.

Verify a receipt

Verification checks whether the supplied receipt evidence matches the stored record and onchain anchor data when anchor data exists.

POST /v1/iso/verify

Verify by bundle hash

curl -X POST http://localhost:8000/v1/iso/verify \
  -H "X-API-Key: dev-admin-CHANGE_ME" \
  -H "Content-Type: application/json" \
  -d '{
    "bundle_hash": "0x..."
  }'

Verify by bundle URL

curl -X POST http://localhost:8000/v1/iso/verify \
  -H "X-API-Key: dev-admin-CHANGE_ME" \
  -H "Content-Type: application/json" \
  -d '{
    "bundle_url": "http://localhost:8000/files/<receipt_id>/evidence.zip"
  }'

Verify by CID

POST /v1/iso/verify-cid

Use this when evidence is referenced by content identifier and the deployment supports that storage path.

Response shape

A verification response can include:

  • matches_onchain
  • bundle_hash
  • flare_txid
  • anchored_at
  • verification errors or mismatch details
Warning

Verification is not a claim that the invoice was valid, the payer intended the transfer, a bank accepted the record, or a regulator certified the workflow. It is a claim about the submitted evidence and its anchor consistency.