Receipts
A payment decision receipt is a signed record of what a wallet’s policy said about one payment request, checked against one specific Arc block, before anything was sent.
Receipts are useful when you need proof for an audit or a customer: what the agent asked for, what the rules said, and what actually happened onchain.
What a receipt contains
- The payment request: wallet, recipient, amount and purpose.
- The decision: allow, escalate, deny or freeze.
- The Arc block the decision was checked against.
- A signature from the Arcanum receipt issuer.
Getting and checking a receipt
import { verifyPaymentReceipt } from "arcanum-sdk"
const { receipt } = await arc.requestPaymentReceipt(intent)
console.log(receipt.receipt.decision.verdict) // "allow" | "escalate" | "deny" | "freeze"
const check = await verifyPaymentReceipt(receipt)
console.log(check.ok)Anyone can verify a receipt against the published list of issuer keys, without trusting Arcanum’s servers.
Receipts and real payments
A receipt is a record of a check, not permission to pay. The contract decides again when the
payment is sent. executePaymentIntentWithReceipt sends the payment and links the
transaction to the receipt, so you can see the decision and the onchain result side by side,
including the rare case where they differ.
A denied request never reaches the chain, so its receipt is the only lasting record of the denial.