Guide

Wallet Engineer Guide

Check a merchant record before rendering a Solana Pay button or Blink Action.

Wallets use OCG to answer one narrow question before payment UI appears: what does this wallet know about the merchant on the other side?

  • Fetch the record by recordId from a wallet-controlled endpoint or trusted read API.
  • Recompute the content hash and compare it to the header or attestation.
  • Run the validator locally.
  • Show the Pay button only when the effective status and policy threshold pass.
  • Render the strongest proof source with issuer, issued date, and expiration date where available.
If effectiveStatus === unknown, do not show a Pay button. Show what is missing instead.