Comprehensive payment processor integration knowledge base covering Polar.sh and Dodo Payments. Use when implementing checkout flows, migrating between processors, configuring webhooks, handling dynamic pricing, or troubleshooting payment issues.
TEMPLATE VERSION: This skill contains placeholder values (e.g.,
<YOUR_POLAR_ACCESS_TOKEN>,<YOUR_POLAR_PRODUCT_ID>). Replace all<YOUR_*>placeholders with your actual credentials before use. Never commit real credentials to version control.
Central knowledge base for all payment processor integrations. Load specific documentation files based on which provider and task you're working on.
payment-processing/
├── SKILL.md # This file - overview & routing
│
├── polar/ # Polar.sh (Current provider)
│ ├── overview.md # Platform overview, env vars, quick start
│ ├── api-reference.md # SDK, endpoints, benefits system
│ ├── customer-migration.md # Migration patterns, common issues
│ └── iframe-checkout.md # Iframe modal, CSP, preloading
│
└── dodo-payments/ # Dodo Payments (Migration target)
├── overview.md # Platform overview, env vars, comparison
├── api-reference.md # SDK, products API, error handling
├── checkout-implementation.md # Sessions, overlay, PWYW dynamic pricing
├── webhook-handling.md # Standard Webhooks, signature verification
└── datafast-integration.md # Revenue attribution setup
| Feature | Polar.sh | Dodo Payments |
|---|---|---|
| Type | Merchant of Record | Merchant of Record |
| Coverage | Global | 190+ countries, 50+ currencies |
| Fees | ~4% + fees | ~4% + 40¢ |
| SDK | @polar-sh/sdk | dodopayments |
| Embedded Checkout | Manual iframe | Overlay SDK |
| Dynamic Pricing | prices object override | PWYW product + amount |
| Webhooks | Custom HMAC SHA256 | Standard Webhooks spec |
| Benefits System | Built-in (files, licenses) | N/A |
| DataFast Integration | Manual | Built-in webhook transform |
# Quick start / overview
Read: .claude/skills/payment-processing/polar/overview.md
# API and SDK usage
Read: .claude/skills/payment-processing/polar/api-reference.md
# Customer migration
Read: .claude/skills/payment-processing/polar/customer-migration.md
# Iframe checkout implementation
Read: .claude/skills/payment-processing/polar/iframe-checkout.md
# Quick start / overview
Read: .claude/skills/payment-processing/dodo-payments/overview.md
# API and SDK usage
Read: .claude/skills/payment-processing/dodo-payments/api-reference.md
# Checkout implementation (sessions, overlay, PWYW)
Read: .claude/skills/payment-processing/dodo-payments/checkout-implementation.md
# Webhook handling
Read: .claude/skills/payment-processing/dodo-payments/webhook-handling.md
# DataFast revenue attribution
Read: .claude/skills/payment-processing/dodo-payments/datafast-integration.md
tool.isFeaturedprices override for custom amountamount in cents| Purpose | File |
|---|---|
| SDK Client | services/polar.ts or services/dodo.ts |
| Product Checkout | server/web/products/actions.ts |
| Ad Checkout | server/web/ads/actions.ts |
| Webhook Handler | app/api/[provider]/webhooks/route.ts |
| Checkout Modal | components/web/[provider]-checkout-modal.tsx |