{"uid":"cap_CUVgMe1LzifKrADEyRZnP","slug":"delx-loyalty-reward-quote-e28e3562","name":"Delx Loyalty Reward Quote","description":"Calculate loyalty points, reward value, effective rebate, and a ledger-ready idempotent credit instruction for $0.001 USDC.","url":"https://api.delx.ai/api/v1/x402/loyalty-reward-quote","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"currency":{"type":"string","default":"USD","maxLength":3,"minLength":3},"event_id":{"type":"string"},"bonus_points":{"type":"integer","default":0,"minimum":0},"points_per_unit":{"type":"number","default":1,"minimum":0},"purchase_amount":{"type":"number","minimum":0},"tier_multiplier":{"type":"number","default":1,"minimum":0},"redemption_value_per_point":{"type":"number","default":0.01,"minimum":0}}},"responseSchema":{"type":"json","example":{"result":{"currency":"USD","base_points":99,"total_points":158,"purchase_amount":"49.99","ledger_instruction":{"unit":"points","amount":158,"event_id":"order-123","operation":"credit","idempotency_required":true},"effective_rebate_pct":"3.16","stores_customer_state":false,"estimated_reward_value":"1.580000"},"tool_name":"util_loyalty_reward_quote"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a81c-bYzZc-zEpZnXHS00","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates loyalty points earned, reward value, effective rebate, and generates a ledger-ready idempotent credit instruction for a given purchase event","exampleAgentPrompt":"Calculate the loyalty reward quote for a $75.00 USD purchase with a tier multiplier of 1.5, 10 bonus points, and a redemption value of $0.01 per point — the event ID is 'order-abc-123'.","exampleUseCases":[{"title":"VIP tier reward calculation at checkout","prompt":"A customer just completed a $120 purchase and they're on our Gold tier with a 2x multiplier — can you calculate their loyalty points earned, the dollar value of those rewards, and generate a ledger credit instruction? Use event ID 'checkout-vip-8821'."},{"title":"Promotional bonus points campaign","prompt":"We're running a promo where customers get 50 bonus points on top of their normal earn rate of 2 points per dollar. Can you compute the total loyalty reward for a $45 USD purchase with event ID 'promo-summer-2024' so I can record it in the ledger?"},{"title":"Effective rebate reporting for finance","prompt":"I need to figure out the effective rebate percentage and reward value for a $200 purchase under our standard loyalty program — 1 point per dollar, $0.01 per point redemption value — and get a credit instruction I can pass to our accounting system. Event ID is 'fin-report-q3-001'."}],"resultDescription":"Returns calculated loyalty points earned for the purchase, the monetary reward value, the effective rebate rate, and a ledger-ready idempotent credit instruction that can be directly applied to a loyalty account ledger without risk of double-crediting.","failureModes":["purchase_amount below minimum (0) returns validation error","invalid currency code (not 3 characters) returns 400","tier_multiplier or points_per_unit set to 0 produces zero-point result","missing required purchase_amount field returns 422 unprocessable entity","duplicate event_id may be used for idempotency — same response returned without recalculation","network timeout at $0.001 USDC payment layer returns 402 before compute"],"whenToPreferThis":"Choose this endpoint when you need a single, authoritative, idempotent computation of loyalty points and reward value for a purchase event — especially when you need a ledger-ready credit instruction that can be safely replayed. Prefer this over manual calculations when tier multipliers, bonus points, and custom redemption rates all need to be factored together in one consistent pass. Ideal for e-commerce checkout flows, post-transaction loyalty crediting pipelines, and finance reporting where double-crediting risk must be eliminated via event_id idempotency.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:14:54.201Z","isFirstParty":false}