Point of Sale

Verify a scanned pass and compute the discount

Verify a scanned pass and compute the discount. X-API-Key required (metered on the partner key). All cryptography stays server-side: InsumerAPI verifies the ECDSA signature on the scanned QR, enforces 65-second freshness, then computes the discount against the merchant config. The partner's scanner only displays the result. A bad signature is rejected with no discount. There is deliberately no companion "sign" endpoint — passes are issued by InsumerAPI's own pass surface; signing is the primitive and is never exposed as an API call.

post/v1/pass/verify

Request

  • Base URL: https://api.insumermodel.com
  • URL: https://api.insumermodel.com/v1/pass/verify
  • Auth: API key in header X-API-Key

Request body

merchantIdstring required

Response

Pass verified

oktrue

Example response

{
  "meta": {
    "version": "1.0"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.