A2P Platform Integration

Resonance acts as the loyalty layer for agentic commerce. Platforms discover our capabilities and plug loyalty/discount functionality into their checkout flows.

UCP (Universal Commerce Protocol)

Discovery

curl https://agent.rsnc.network/.well-known/ucp

Returns our capability manifest:

• loyalty.check — Check user reward balance across brands
• loyalty.earn — Record purchases to earn cashback
• discount.list — Browse available discounts and perks
• discount.apply — Calculate optimal deal stack with discount codes
• commerce.route — Find the best brand for a purchase
• commerce.compare — Compare cashback rates across brands

Discount Extension

UCP agents can use our discount capabilities at checkout:

1. Call discount.list to get available discounts for the user
2. Present discounts in the cart UI
3. Call discount.apply to calculate the optimal stack
4. Apply returned discount_code values at checkout
5. Call loyalty.earn post-purchase to record cashback

Auth for UCP

• HMAC — For agent/brand identity (who is calling)
• OAuth 2.0 Bearer — For user identity linking (whose rewards to check)

Both can be used simultaneously on a single request.

ACP (Agentic Commerce Protocol)

Resonance integrates as a sidecar to ACP checkout flows:

Pre-Checkout

Shopping Agent → Resonance (route_purchase / stack_deals)
  → Returns optimal brand + discount codes
Shopping Agent → ACP Merchant (UpdateCheckoutRequest with discount codes)

Post-Checkout

ACP Merchant → Webhook → Resonance (track_purchase)
  → Cashback recorded for user

Discount Codes

Perks carry discount_code values configured by brands. When stack_deals returns applicable perks, the discount codes are included in the response for the shopping agent to pass through to the ACP checkout.

Shopify Agents

Resonance integrates as a Discount Extension alongside Shopify's Catalog and Checkout MCPs:

1. Catalog MCP discovers products
2. Resonance Agent provides loyalty discounts via stack_deals / browse_perks
3. Checkout MCP applies discount codes at checkout
4. Resonance Agent records the purchase via track_purchase

Integration Steps

1. Discover Resonance via /.well-known/ucp or /.well-known/a2a/agent-card
2. Use MCP tools (rsnc_agent_stack_deals, rsnc_agent_browse_perks) or A2A skills (apply_loyalty, best_deals)
3. Apply returned discount codes in Shopify Cart
4. Post-purchase: call track_purchase to record cashback

Transports

All platform integrations support three transports:

Transport	URL	Best For
REST (A2A)	https://agent.rsnc.network/tasks/send	Simple HTTP integration
MCP	https://agent.rsnc.network/mcp	Rich tool calling with resources & prompts
Discovery	https://agent.rsnc.network/.well-known/ucp	Platform auto-discovery