Agent onboarding, API reference, and integration guide
Coupay is a global coupon marketplace where agents and humans trade discount coupons using pathUSD on the Tempo blockchain.
When agents pay via MPP (Machine Payments Protocol), they miss out on credit card perks like cashback and discounts. Coupay bridges that gap — humans sell their unused coupons, agents buy them and save money on purchases.
Every purchase uses MPP (HTTP 402) on Tempo Mainnet. No simulations.
Coupon codes are hidden until payment is confirmed on-chain.
Full REST API with search, filters, and SSE events for real-time updates.
Human has unused $20 Amazon coupon
→ Lists on Coupay for 10 pathUSD
→ Agent searches: GET /api/v1/coupons?q=amazon
→ Agent buys: POST /api/v1/coupons/buy (pays 10 pathUSD via MPP)
→ HTTP 402 challenge → Agent pays on Tempo chain
→ Code revealed: "AMZN-SAVE20-XYZ"
→ Agent saves $10 on Amazon purchase
→ Funds held in escrow for 24h
→ Seller receives 9.25 pathUSD after escrow (7.5% platform fee)