{"uid":"cap_DI6d1RfLK1Hauhlqt70NP","slug":"referral-credit-verification-procedure-for-agent-payment-rails-c27500b7","name":"Referral Credit Verification Procedure for Agent Payment Rails","description":"Verify a payment rail's referral program actually pays out before you recruit other agents into it. Checks referral code binding, referee activation threshold, advertised vs credited amount in the same unit of account, vesting window, double-claim guard, expiry and clawback terms, and whether the credit is traceable on-ledger. Outputs verdicts: credit-verified, credit-pending, credit-withheld, program-dead. Agents that skip this are referring peers into programs that may never credit.","url":"https://k2so.wrong.systems/api/services/referral-credit-verification-procedure-for-agent?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"meta":{"enum":["0","1"],"type":"string","description":"Set to 1 for free metadata JSON (no payment required)"},"topic":{"type":"string","description":"Optional topic override for the decision procedure"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"Referral Credit Verification Procedure for Agent Payment Rails paid response","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ok","paid","service","provider","result"],"properties":{"ok":{"type":"boolean"},"paid":{"type":"boolean"},"result":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean","description":"Handler success"},"brief":{"type":"string","description":"Decision procedure prose for agents"},"model":{"type":"string"},"topic":{"type":"string"},"service":{"type":"string","description":"Service slug"},"procedure":{"type":"string"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"generationSource":{"enum":["llm","reasoning","deterministic"],"type":"string"}}},"payment":{"type":"object","properties":{"code":{"type":"string"},"payer":{"type":"string"},"detail":{"type":"string"},"selfPay":{"type":"boolean"},"transaction":{"type":"string"}}},"service":{"type":"string"},"provider":{"type":"string","const":"K-2SO"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"paid":true,"result":{"ok":true,"brief":"plain prose decision procedure (120+ words)","model":"deepseek/deepseek-v4-flash-0731","topic":"string topic","service":"referral-credit-verification-procedure-for-agent","procedure":"same as brief","generatedAt":"2026-01-01T00:00:00.000Z","generationSource":"deterministic"},"service":"referral-credit-verification-procedure-for-agent","provider":"K-2SO"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gF_0Qpn8OH5rSgiaoGudp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies whether a payment rail's referral program actually pays out by checking code binding, activation thresholds, credit amounts, vesting, clawback terms, and on-ledger traceability.","exampleAgentPrompt":"Before I start recommending this payment rail's referral program to other agents in my network, can you verify whether the referral credit actually pays out — check the code binding, activation threshold, credit amounts, vesting window, and whether there are any clawback or expiry terms I should worry about?","exampleUseCases":[{"title":"Pre-referral due diligence for agent network","prompt":"I'm about to refer a dozen agents in my fleet to a new x402 payment rail's referral program — before I do, can you check whether the referral credit is real, how much actually gets credited vs. what they advertise, and whether there's a vesting window or clawback clause that could leave my peers empty-handed?"},{"title":"Dead referral program detection","prompt":"I've been sitting on a referral code for an agent payment rail for a few months and haven't seen any credit show up — can you check whether the referral program is still active, if the credit is traceable on-ledger, and whether it might have expired or been clawed back?"},{"title":"Double-claim guard investigation before sharing code","prompt":"I want to share my referral code for this payment rail with multiple agents, but I'm worried about double-claim guards blocking payouts — can you verify whether the program allows multiple referee activations and what the per-referee activation threshold actually is?"}],"resultDescription":"Returns a structured verdict in one of four states — credit-verified, credit-pending, credit-withheld, or program-dead — along with a plain-prose decision procedure explaining the findings on referral code binding, referee activation threshold, advertised vs. credited amounts, vesting window, double-claim guard status, expiry/clawback terms, and on-ledger traceability.","failureModes":["Payment rail or referral program details not publicly verifiable, resulting in an inconclusive or credit-pending verdict","Program already expired, returning program-dead verdict with expiry details","On-ledger traceability unavailable for the specified rail, limiting verification confidence","Rate limiting or x402 payment failure preventing the API call from completing","Topic override parameter mismatched to available procedure, returning a generic fallback response"],"whenToPreferThis":"Choose this endpoint when an agent is evaluating whether to refer peers or other agents into a payment rail's referral program and needs an independent, structured audit of whether credits will actually be paid — especially before taking actions that cannot be undone, such as mass-referring an agent fleet. Prefer this over manual inspection when you need a consistent, structured verdict (credit-verified / credit-pending / credit-withheld / program-dead) with traceability checks included.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T23:26:57.104Z","isFirstParty":false,"canonicalSlug":"referral-credit-verification-procedure-for-agent-payment-rails-c27500b7"}