Claim Merchants Social Rewards Skill

Overview

Claim is a social commerce and rewards operating system (acquired by Grubhub's parent company, Wonder) that enables local and online merchants (especially restaurants and retailers) to run risk-free, pay-per-acquisition marketing drops. This skill enables GenPark AI agents to construct, manage, and analyze Claim campaigns, matching high-intent customers with products/venues using transactional card-linked mechanics.

sequenceDiagram
    autonumber
    actor Customer
    participant App as Claim Consumer App
    participant Plaid as Plaid API
    participant Merchant as Claim Merchant OS
    participant Venmo as Venmo API

    Customer->>App: Link debit/credit card via Plaid
    Merchant->>Merchant: Create "Thursday Drop" offer ($5 cash back)
    App->>Customer: Delivers offer to user's wallet
    Customer->>Merchant: Swipes physical credit card at check-out
    Plaid->>Merchant: POST /v1/merchant/webhooks/transaction (Matches linked card swipe)
    Merchant->>Venmo: POST /v1/payouts (Trigger cashback payment)
    Venmo-->>Customer: $5 cash back deposited to customer Venmo

Core Capabilities

1. Pay-Per-Acquisition Drops (New Customers)

• Weekly Custom Drops: Launch targeted cashback campaigns that "drop" in customer wallets every Thursday.
• Zero Upfront Costs: Merchants pay purely on performance. A fee is only collected when an offer is successfully claimed and a transaction is completed.
• Social Amplification: Users can trade or gift rewards with their friends in the app, naturally extending brand reach via viral word-of-mouth discovery.

2. Card-Linked POS Redemption (Frictionless Operations)

• Zero Operational Friction: No coupons, promo codes, staff training, or custom QR-code POS integrations required. Purchases are auto-verified in the background.
• Plaid Financial Integrations: Leverages Plaid to securely monitor transaction streams for linked credit/debit card activity at merchant locations.

3. Customer Retention & Repeat Visits

• Regulars Nudging: Automatically trigger follow-up retention rewards when a first-time customer completes a dining/shopping "Claim" offer to convert them into standard regulars.
• Cohort Segmentation: Identify and segment first-time diners/shoppers from repeat regulars to adjust incentive scaling.

4. Performance & Competitor Benchmarking

• First-Party Insights: Track detailed customer demographics, purchase baskets, lifetime value (LTV), and frequency.
• Competitor Indexing: Gain real-time, aggregated data on how your establishment ranks against similar local competitors in market share and repeat loyalty.

API Reference & Payloads

1. Launch a Rewards Offer Campaign

POST https://api.claim.co/v1/merchant/campaigns

Request Headers:

Authorization: Bearer <your_claim_merchant_token>
Content-Type: application/json

Request Payload:

{
  "name": "Thursday Diner Drop - May 2026",
  "campaign_type": "ACQUISITION_DROP",
  "cashback_amount": 5.00,
  "start_date": "2026-05-21T00:00:00Z",
  "end_date": "2026-05-28T23:59:59Z",
  "target_criteria": {
    "geographic_radius_miles": 5.0,
    "competitor_categories": ["casual_dining", "coffee_shops"]
  },
  "max_budget": 500.00
}

Response Payload:

{
  "campaign_id": "camp_88910243",
  "status": "SCHEDULED",
  "cashback_amount": 5.00,
  "targeted_users_estimate": 4500,
  "created_at": "2026-05-18T18:56:00Z"
}

2. Webhook: Card-Linked Transaction Matched

POST https://api.claim.co/v1/merchant/webhooks/transaction

Request Payload (Sent by Plaid/Claim to Merchant):

{
  "event_id": "evt_9981240a2",
  "event_type": "transaction.matched",
  "timestamp": "2026-05-18T18:56:46Z",
  "data": {
    "merchant_id": "merch_770123",
    "customer_id": "cust_44901",
    "campaign_id": "camp_88910243",
    "transaction": {
      "amount": 24.50,
      "currency": "USD",
      "timestamp": "2026-05-18T18:55:00Z",
      "masked_card_last_four": "1024"
    }
  }
}

Response Payload:

{
  "status": "PROCESSED",
  "payout_status": "VENMO_QUEUED",
  "cashback_awarded": 5.00,
  "fee_charged": 1.50
}

Agent Usage & Best Practices

AI agents should model Claim campaigns using these strategic guidelines:

1. Risk-Free Budget Management: When launching local drops, set a strict max_budget. Since fees are pay-per-acquisition, the maximum financial liability is bounded by this budget.
2. Attribution Signature Verification: Always verify webhook signatures on transaction events to ensure payouts are only triggered by legitimate card-linked hits from the Claim system.
3. Cross-Channel Retention: When an acquisition drop shows high conversions, the agent should automatically spawn a secondary RETENTION_CAMPAIGN targeting those same customers to secure double visits within 14 days.

References

• Claim Merchant Support
• Plaid Transactions API
• Claim and Grubhub Acquisition Details