{"uid":"cap_ROMqCqdoCc3fQqKuOed84","slug":"agent-risk-desk-near-allowance-vault-receipt-verifier-de8ac7fe","name":"Agent Risk Desk – NEAR Allowance Vault Receipt Verifier","description":"Seller-side check that an Allowance vault receipt on NEAR paid a given account at least a given amount, bound to the seller request hash, at final finality. Returns valid or the reason (not paid yet, wrong payee, amount, asset or request, unknown receipt, not a vault) and the vault code hash read at the same block.","url":"https://x402-services.soldano.workers.dev/v1/receipt/verify-near?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"asset":{"anyOf":[{"type":"string","const":"near"},{"type":"object","required":["ft"],"properties":{"ft":{"type":"string","pattern":"^(([a-z\\d]+[-_])*[a-z\\d]+\\.)*([a-z\\d]+[-_])*[a-z\\d]+$","maxLength":64,"minLength":2,"description":"NEAR account id, e.g. alice.near or a 64-hex implicit account"}}}],"description":"\"near\" (default) or {\"ft\": \"<NEP-141 token contract>\"}"},"nonce":{"type":"string","maxLength":256,"description":"alternative to requestHash: the nonce the seller issued; the hash is computed server-side"},"payee":{"type":"string","pattern":"^(([a-z\\d]+[-_])*[a-z\\d]+\\.)*([a-z\\d]+[-_])*[a-z\\d]+$","maxLength":64,"minLength":2,"description":"the account that must have been paid (usually the seller itself)"},"vault":{"type":"string","pattern":"^(([a-z\\d]+[-_])*[a-z\\d]+\\.)*([a-z\\d]+[-_])*[a-z\\d]+$","maxLength":64,"minLength":2,"description":"Allowance vault account that issued the receipt"},"network":{"enum":["mainnet","testnet"],"type":"string","description":"NEAR network; default: testnet for *.testnet accounts, mainnet otherwise"},"minAmount":{"type":"string","pattern":"^\\d{1,40}$","description":"minimum amount in base units: yoctoNEAR, or the token smallest unit when asset is an ft"},"receiptId":{"type":"integer","maximum":9007199254740991,"minimum":0,"description":"receipt id returned by the vault pay call"},"requestHash":{"type":"string","description":"base64(sha256(utf8(nonce))): the 32-byte request hash the receipt must carry"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xcSr3V0STJGAiNFr4AL3h","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies that a NEAR Allowance vault receipt paid a specified account at least a given amount, bound to the seller's request hash, at final finality, returning valid or a specific failure reason plus the vault code hash.","exampleAgentPrompt":"Check whether NEAR vault receipt #42 from vault 'myvault.near' on mainnet actually paid 'myshop.near' at least 1000000000000000000000000 yoctoNEAR and is properly bound to my seller nonce 'order-abc-123'.","exampleUseCases":[{"title":"Seller confirms buyer NEAR payment before fulfilling order","prompt":"Before I ship the digital download, verify that NEAR allowance vault receipt #7 from vault 'buyervault.near' on mainnet paid 'mystore.near' at least 500000000000000000000000 yoctoNEAR and is tied to nonce 'order-20240601-xyz'."},{"title":"Validate NEP-141 token payment for API access","prompt":"Check that vault receipt #3 issued by 'clientvault.near' on NEAR mainnet paid 'apiprovider.near' at least 1000000 units of the USDC token contract 'usdc.tether-token.near', bound to request hash 'dGhpcyBpcyBhIHRlc3Q='."},{"title":"Debug why a NEAR x402 payment was rejected","prompt":"I'm getting a payment failure — can you verify receipt #15 from 'testvault.testnet' on testnet and tell me exactly why it's not being accepted as valid payment to 'merchant.testnet' for nonce 'session-999'?"}],"resultDescription":"A JSON response indicating whether the receipt is valid or, if not, the specific reason (e.g. not paid yet, wrong payee, wrong amount, wrong asset, wrong request hash, unknown receipt, or not a vault contract), along with the vault's code hash read at the same block height used for verification.","failureModes":["Receipt not yet at final finality — returns 'not paid yet'","Wrong payee — receipt paid a different account than specified","Amount too low — paid amount is below the specified minAmount","Wrong asset — payment used a different token than requested","Request hash mismatch — receipt not bound to the provided nonce/requestHash","Unknown receipt ID — vault does not recognise the receiptId","Not a vault — the vault account is not an Allowance vault contract","Invalid NEAR account ID format — pattern validation failure on vault or payee","Network mismatch — testnet vault queried as mainnet or vice versa"],"whenToPreferThis":"Use this endpoint when you need server-side, final-finality verification of a NEAR Allowance vault receipt in an x402 seller flow — specifically when you need to confirm payee identity, minimum amount, asset type, and binding to a seller request hash in a single call. Prefer this over building your own NEAR RPC queries when you want a human-readable failure reason and the vault code hash in one response without managing NEAR node connections yourself.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:30:23.114Z","isFirstParty":false,"canonicalSlug":"agent-risk-desk-near-allowance-vault-receipt-verifier-de8ac7fe"}