# Loyal Spark - Prepare Reward Redemption

> Loyal Spark - Prepare Reward Redemption is a paid API for AI agents from api.loyalspark.online, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Prepares and initiates an onchain loyalty reward redemption workflow for a customer on the Base Network via Loyal Spark's recipient API.

## Facts

- Endpoint: POST https://api.loyalspark.online/x402-gateway/recipient-api/workflow/prepare-reward-redemption
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/loyal-spark-prepare-reward-redemption-67693f53
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hhwn0fPamGAxFFl-KPh7Q

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 loyal-spark-prepare-reward-redemption-67693f53 -d '<json body>'
```

Example prompt: My customer at Morning Bloom Coffee just wants to redeem their Loyal Spark loyalty tokens — can you prepare the onchain redemption workflow for them using a POST request with their redemption details as JSON?

## When to prefer this

Use this endpoint when an AI agent or application needs to initiate or prepare a loyalty reward redemption on behalf of a recipient within the Loyal Spark onchain loyalty ecosystem on Base Network. Prefer this over generic payment endpoints when the use case specifically involves ERC-20 branded loyalty token redemption through Loyal Spark's recipient workflow.

## Known failure modes

- Missing or invalid required fields in the body result in a 400 validation error
- Insufficient loyalty token balance causes redemption preparation to fail
- Onchain Base Network congestion or RPC errors may cause timeouts
- Invalid or expired session/auth headers return 401 or 403
- Malformed bodyType or method enum values cause schema validation rejection
- Payment of $0.005 USDC not received causes x402 gateway to block the request

## How this service works

Onchain loyalty platform on Base Network. Businesses launch branded rewards in minutes, customers earn real value with every purchase, and AI agents automate the rest via REST and MCP. Free plan mints up to 1,000 tokens per month; every call is scoped by row-level security to the wallet behind the API key. 16 skill guides at loyalspark.online/.well-known/skills/index.md.

## Output

Returns a JSON response from the Loyal Spark recipient-api describing the prepared redemption workflow state, including any onchain transaction data or next steps required to complete the reward redemption on Base Network.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {}
   }
  },
  "inputSchema": {
   "type": "object"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "schema": {
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema"
 },
 "description": "JSON from Loyal Spark agent-api or recipient-api. See OpenAPI for response shape."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/loyal-spark-prepare-reward-redemption-67693f53/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.loyalspark.online](https://www.zero.xyz/host/api.loyalspark.online/llms.txt)