# Delx Commerce Loyalty Reward Quote

> Delx Commerce Loyalty Reward Quote is a paid API for AI agents from commerce.delx.ai, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-01).

Calculates loyalty points earned and estimated reward value for a purchase, returning a ledger-ready credit instruction.

## Facts

- Endpoint: POST https://commerce.delx.ai/api/v1/x402/loyalty-reward-quote?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/delx-commerce-loyalty-reward-quote-880fa59e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oc0-FhAIigCdcL_vN7jxu

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability delx-commerce-loyalty-reward-quote-880fa59e -d '<json body>'
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Pay-per-result APIs for agents. No signup. Exact price. Verifiable delivery. USDC on Base + Solana via x402.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/delx-commerce-loyalty-reward-quote-880fa59e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from commerce.delx.ai](https://www.zero.xyz/host/commerce.delx.ai/llms.txt)