{"uid":"cap_oc0-FhAIigCdcL_vN7jxu","slug":"delx-commerce-loyalty-reward-quote-880fa59e","name":"Delx Commerce Loyalty Reward Quote","description":"Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.","url":"https://commerce.delx.ai/api/v1/x402/loyalty-reward-quote?utm_source=zero.xyz","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_Tf36bsC96MhFEH5lDu837","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 and estimated reward value for a purchase, returning a ledger-ready credit instruction.","exampleAgentPrompt":"Calculate the loyalty points and reward value for a $49.99 USD purchase using a 2x tier multiplier, 10 bonus points, 1 point per dollar, and a redemption value of $0.01 per point — the event ID is order-123.","exampleUseCases":[{"title":"Tiered loyalty points at checkout","prompt":"A customer just completed a $75.00 USD purchase and they're a Gold-tier member with a 1.5x multiplier — can you calculate how many loyalty points they earn and what the dollar reward value is, using 1 point per dollar and $0.01 per point redemption, for event order-456?"},{"title":"Promotional bonus points campaign","prompt":"We're running a promo where customers get 50 bonus points on top of normal earnings. Can you quote the total points and reward value for a $30.00 USD order with the standard 1 point per dollar, 1x multiplier, and $0.01 redemption rate? Event ID is promo-789."},{"title":"Ledger instruction for loyalty platform","prompt":"I need a ready-to-post ledger credit instruction for a $120.00 USD purchase with a 2x tier multiplier, 0 bonus points, 1 point per dollar, and $0.01 per point redemption — event ID is txn-2024-001."}],"resultDescription":"Returns base points earned, total points (including tier multiplier and bonus), estimated reward value in the specified currency, effective rebate percentage, and a structured ledger_instruction object with operation type (credit), amount, event_id, unit, and idempotency flag — ready to post directly to a loyalty ledger system.","failureModes":["Missing required purchase_amount returns validation error","Negative values for points_per_unit or tier_multiplier rejected by minimum constraint","Invalid currency code (not 3 characters) fails schema validation","Payment required error (HTTP 402) if USDC micropayment via x402 is not included","Malformed event_id or missing idempotency handling may cause duplicate ledger entries on retry"],"whenToPreferThis":"Use this endpoint when you need a stateless, pay-per-call loyalty points calculation without maintaining a loyalty ledger yourself — ideal for agents orchestrating checkout flows, loyalty platforms that need a computation step before writing to their own ledger, or any scenario requiring a verifiable, on-chain-paid quote for reward points without a subscription or API key.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T00:53:58.930Z","isFirstParty":false,"canonicalSlug":"delx-commerce-loyalty-reward-quote-880fa59e"}