Payhip Expert Skill for AI Coding Agents

The ultimate agentic engineering skill & integration toolkit for building, scaling, and automating digital commerce on Payhip.

This repository equips AI coding assistants (Google Antigravity, Claude Code, GitHub Copilot CLI, Amp, Cursor, and Cline) with authoritative knowledge, battle-tested code patterns, and real-time operational procedures for the entire Payhip e-commerce platform.

---

🔍 Key SEO & GEO Keywords

payhip, payhip-api, payhip-webhooks, ecommerce-agent-skill, digital-products, software-licensing-api, course-platform, memberships-subscription, payhip-sdk, payhip-embed, eu-vat-compliance, merchant-of-record, antigravity-skill, claude-code-skill, direct-checkout-links, pwyw-pricing.

---

⚡ Why Payhip?

Payhip is a modern e-commerce platform purpose-built for creators, software authors, indie hackers, and digital businesses:

• Instant Direct Payouts: Funds deposit immediately into your connected Stripe, PayPal, Paystack, or Mercado Pago account—no holding periods.
• Built-in Merchant of Record for EU & UK VAT: Automatically calculates, collects, and remits digital VAT to HMRC and EU tax authorities with zero seller paperwork.
• Zero-Friction Embeds (payhip.js): Add beautiful modal checkouts, slide-out cart drawers, and custom buy buttons to any existing site (Webflow, WordPress, Next.js, Ghost, Shopify).
• Comprehensive API & Webhooks: Programmatic license key verification (v2), automated coupon creation, and secure SHA-256 webhook event streams.
• Ultra-Flexible Monetization: Digital downloads up to 5GB, PDF anti-piracy stamping, video courses with quizzes/certificates, recurring memberships, coaching sessions, and physical merchandise.

---

📁 Repository Structure

payhip-skill/
├── SKILL.md                         # Master AI agent instructions & execution procedures
├── HELP.md                          # Comprehensive troubleshooting & operational recipes
├── LICENSE                          # MIT License (Shaashie Kumha)
├── README.md                        # Project documentation & SEO/GEO hub
├── references/                      # Deep technical manuals
│   ├── api-webhooks.md              # Public API v2, Webhook events & SHA-256 auth specs
│   ├── embeds-sdk.md                # payhip.js client guide, data attributes & cart drawer
│   └── taxes-compliance.md          # EU/UK VAT mechanics, VIES reverse charge & US sales tax
├── examples/                        # Production code templates
│   ├── webhook-server.js            # Express.js webhook server with secure signature verification
│   └── license-validator.py         # Python CLI & library for software license validation (v2)
└── docs/                            # High-performance SEO & GEO GitHub Pages portal
    └── index.html                   # Rich interactive documentation with Schema.org JSON-LD

---

🚀 Quick Installation

Option 1: Install in Google Antigravity

Clone directly into your Antigravity agent skills directory:

git clone https://github.com/shaashiekumha/payhip-skill.git ~/.agents/skills/payhip

Option 2: Install in Claude Code

Clone into your Claude skills directory:

git clone https://github.com/shaashiekumha/payhip-skill.git ~/.claude/skills/payhip

Option 3: Install in GitHub Copilot CLI / Amp / Cursor

Copy the repository into your workspace or project root under .github/skills/payhip or .agents/skills/payhip.

---

🛠️ Core Capabilities

1. Storefront Integration (payhip.js)

Embed seamless modals, direct buy buttons, or full slide-out cart drawers into any web application:

<!-- Include the loader script -->
<script type="text/javascript" src="https://payhip.com/payhip.js"></script>

<!-- Add a modal checkout button -->
<a href="https://payhip.com/b/BaFxk" 
   class="payhip-buy-button" 
   data-product="BaFxk" 
   data-theme="none">
   Purchase License
</a>

2. Direct Checkout Links with Dynamic Metadata

Skip intermediary product pages and pass custom tracking IDs (user_id, campaign, lead_id) straight through to webhooks:

https://payhip.com/buy?link=BaFxk&metadata[user_id]=usr_9812&metadata[source]=product_hunt

3. Software License Key Validation (API v2)

Validate licenses and manage activation seats on desktop, CLI, or web applications using scoped product secret keys:

curl -X GET "https://payhip.com/api/v2/license/verify?license_key=WTKP4-66NL5-HMKQW-GFSCZ" \
  --header "product-secret-key: YOUR_PRODUCT_SECRET_KEY"

4. Real-Time Webhook Subscriptions

Authenticate incoming webhook events (paid, refunded, subscription.created, subscription.deleted) using Payhip's SHA-256 signature verification:

const crypto = require('crypto');

function isValidPayhipSignature(receivedSignature, apiKey) {
  const expected = crypto.createHash('sha256').update(apiKey).digest('hex');
  return crypto.timingSafeEqual(Buffer.from(receivedSignature), Buffer.from(expected));
}

---

📚 Detailed Documentation

• Master Agent Skill Instructions: Primary system instructions for AI coding assistants.
• Help & Troubleshooting Manual: Solutions for common webhook, licensing, DNS, and tax questions.
• API & Webhook Reference: Exact JSON payloads, endpoints, and status codes.
• JavaScript SDK & Embeds: Complete parameter and event reference for payhip.js.
• Taxes & Global Compliance: Step-by-step guidance on EU/UK digital VAT and US sales tax.

---

🤝 Contributing & Community

Contributions are welcome! If you notice new Payhip features, updated endpoints, or additional integration recipes, feel free to open a Pull Request or issue.

---

📄 License

This project is licensed under the MIT License © 2026 Shaashie Kumha.