Skill

payment-integration

Payment gateway integration. Providers: SePay (Vietnamese: VietQR, bank transfer, cards), Polar (global SaaS: subscriptions, usage-based billing). SDKs: Node.js, PHP, Python, Go, Laravel, Next.js. Capabilities: checkout flows, subscription management, webhooks, QR code generation, benefit automation, tax compliance. Actions: integrate, implement, configure, handle payments/subscriptions/webhooks. Keywords: payment gateway, SePay, Polar, VietQR, bank transfer, subscription, usage-based billing, checkout, webhook, QR code, API key, OAuth2, product management, customer portal, tax compliance, MoR, recurring payment, invoice. Use when: integrating payment processing, implementing checkout, managing subscriptions, handling payment webhooks, generating payment QR codes, building billing systems.

Install

npx claudepluginhub joshuarweaver/cascade-code-languages-misc-1 --plugin samhvw8-dot-claude

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Implement payment processing with SePay (Vietnamese payments) and Polar (global SaaS monetization).

Supporting Assets

SKILL.md

Similar Skills

skill-lookup

Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.

prompts.chat

159.9k

prompt-lookup

Searches prompts.chat for AI prompt templates by keyword or category, retrieves by ID with variable handling, and improves prompts via AI. Use for discovering or enhancing prompts.

prompts.chat

159.9k

next-compile

1 file

Checks Next.js compilation errors using a running Turbopack dev server after code edits. Fixes actionable issues before reporting complete. Replaces `next build`.

vercel-next-js-2

139.2k

Stats

Stars10

Forks0

Last CommitDec 9, 2025

Actions

View Source View Plugin View on GitHub View README

Payment Integration

Implement payment processing with SePay (Vietnamese payments) and Polar (global SaaS monetization).

When to Use

Use when implementing:

Payment gateway integration (checkout, processing)
Subscription management (trials, upgrades, billing)
Webhook handling (payment notifications)
QR code payments (VietQR, NAPAS)
Usage-based billing (metering, credits)
Automated benefit delivery (licenses, GitHub access, Discord roles)
Customer portals (self-service management)
Bank transfer automation (Vietnamese banks)
Product catalogs with pricing

Platform Selection

Choose SePay for:

Vietnamese market (VND currency)
Bank transfer automation
VietQR/NAPAS payments
Local payment methods
Direct bank account monitoring

Choose Polar for:

Global SaaS products
Subscription management
Usage-based billing
Automated benefits (GitHub, Discord, licenses)
Merchant of Record (tax compliance)
Digital product sales

Quick Reference

SePay Integration

Overview & Auth: references/sepay/overview.md - Platform capabilities, API/OAuth2 auth, supported banks
API Reference: references/sepay/api.md - Endpoints, transactions, bank accounts, virtual accounts
Webhooks: references/sepay/webhooks.md - Setup, payload structure, verification, retry logic
SDK Usage: references/sepay/sdk.md - Node.js, PHP, Laravel implementations
QR Codes: references/sepay/qr-codes.md - VietQR generation, templates, integration
Best Practices: references/sepay/best-practices.md - Security, patterns, monitoring

Polar Integration

Overview & Auth: references/polar/overview.md - Platform capabilities, authentication methods, MoR concept
Products & Pricing: references/polar/products.md - Product types, pricing models, usage-based billing
Checkouts: references/polar/checkouts.md - Checkout flows, embedded checkout, links
Subscriptions: references/polar/subscriptions.md - Lifecycle, upgrades, downgrades, trials
Webhooks: references/polar/webhooks.md - Event types, signature verification, monitoring
Benefits: references/polar/benefits.md - Automated delivery (GitHub, Discord, licenses, files)
SDK Usage: references/polar/sdk.md - TypeScript, Python, PHP, Go, framework adapters
Best Practices: references/polar/best-practices.md - Security, patterns, monitoring

Integration Scripts

SePay Webhook Verification: scripts/sepay-webhook-verify.js - Verify SePay webhook authenticity
Polar Webhook Verification: scripts/polar-webhook-verify.js - Verify Polar webhook signatures
Checkout Helper: scripts/checkout-helper.js - Generate checkout sessions for both platforms

Implementation Workflow

SePay Implementation

Load references/sepay/overview.md for auth setup
Load references/sepay/api.md or references/sepay/sdk.md for integration
Load references/sepay/webhooks.md for payment notifications
Use scripts/sepay-webhook-verify.js for webhook verification
Load references/sepay/best-practices.md for production readiness

Polar Implementation

Load references/polar/overview.md for auth and concepts
Load references/polar/products.md for product setup
Load references/polar/checkouts.md for payment flows
Load references/polar/webhooks.md for event handling
Use scripts/polar-webhook-verify.js for webhook verification
Load references/polar/benefits.md if automating delivery
Load references/polar/best-practices.md for production readiness

Key Capabilities

SePay:

Payment gateway (QR, bank transfer, cards)
Bank account monitoring with webhooks
Order-based virtual accounts
VietQR generation API
44+ Vietnamese banks supported
Rate limit: 2 calls/second

Polar:

Merchant of Record (global tax compliance)
Subscription lifecycle management
Usage-based billing (events, meters)
Automated benefits (GitHub, Discord, licenses)
Customer portal (self-service)
Multi-language SDKs
Rate limit: 300 req/min

Instructions

When implementing payment integration:

Identify platform based on requirements (Vietnamese vs global, payment types)
Load relevant references progressively as needed
Implement authentication using platform-specific methods
Set up products/pricing according to business model
Implement checkout flow (hosted, embedded, or API-driven)
Configure webhooks with proper verification
Handle payment events (success, failure, refund)
Test thoroughly in sandbox before production
Monitor and optimize using platform analytics

Load only the references needed for current implementation step to maintain context efficiency.