{"uid":"cap_ZxR4m3-TJneg_vXB_Iemn","slug":"loyal-spark-claim-gift-certificate-ba938958","name":"Loyal Spark - Claim Gift Certificate","description":"Onchain loyalty protocol on Base L2. Launch B20 rewards, earn and redeem tokens, trade P2P, automate with AI agents via REST and MCP.","url":"https://api.loyalspark.online/x402-gateway/recipient-mcp-tools/claim_gift_certificate","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","toolName","inputSchema"],"properties":{"type":{"type":"string","const":"mcp"},"example":{"type":"object"},"toolName":{"type":"string"},"transport":{"enum":["streamable-http","sse"],"type":"string"},"description":{"type":"string"},"inputSchema":{"type":"object"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{}}}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_CQ6LiEPKlX6I6YhQ7j1qb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Claims a gift certificate within the Loyal Spark onchain loyalty protocol on Base L2, redeeming it for ERC-20 reward tokens.","exampleAgentPrompt":"I have a Loyal Spark gift certificate for the 'MorningBloom Coffee' loyalty program — can you claim it to my wallet 0xABC123... and redeem it for their reward tokens?","exampleUseCases":[{"title":"Redeem employee bonus gift certificates","prompt":"Our company uses Loyal Spark for employee rewards — can you claim these three gift certificates for our team members and convert them to their ERC-20 tokens so they can trade them on the rewards marketplace?"},{"title":"Activate merchant loyalty program rewards","prompt":"I just got a gift certificate from my favorite boutique's loyalty program on Loyal Spark — please claim it to my wallet and turn it into their native reward tokens so I can earn more benefits."},{"title":"Process bulk loyalty redemptions","prompt":"We're migrating 50 customers to our new Loyal Spark loyalty program and need to activate their gift certificates in batch — can you claim each one and send them their ERC-20 rewards tokens?"}],"resultDescription":"Returns a JSON object confirming the gift certificate claim, including the transaction hash on Base L2, the amount of ERC-20 loyalty tokens received, the recipient wallet address, the redeemed certificate identifier, and the redemption status.","failureModes":["Gift certificate already claimed — returns error indicating the certificate has been previously redeemed","Invalid or expired gift certificate code — returns validation error","Recipient wallet address not found or invalid — returns address error","Loyalty program not found or inactive — returns program lookup error","Insufficient network gas or blockchain congestion — returns timeout or gas error","Payment of $0.01 USDC not completed — returns x402 payment required error"],"whenToPreferThis":"Use this endpoint when an AI agent or user needs to redeem a specific gift certificate within the Loyal Spark onchain loyalty ecosystem on Base L2. Prefer this over generic token transfer endpoints when the redemption involves a gift certificate code tied to a specific merchant loyalty program. Ideal for automating loyalty reward workflows where users receive gift certificates and need them converted to spendable ERC-20 tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:57:27.341Z","isFirstParty":false}