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.
How do I install this agent skill?
npx skills add https://github.com/samhvw8/dot-claude --skill payment-integrationIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive documentation and utility scripts for integrating SePay and Polar payment platforms. It includes guides for authentication, API usage, and webhook handling, alongside Node.js scripts for signature verification and checkout generation. The skill follows security best practices by recommending environment variables for secret management and implementing signature validation for webhooks.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 2 issues
- Runlayerwarn
7/22 files flagged
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
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.mdfor auth setup - Load
references/sepay/api.mdorreferences/sepay/sdk.mdfor integration - Load
references/sepay/webhooks.mdfor payment notifications - Use
scripts/sepay-webhook-verify.jsfor webhook verification - Load
references/sepay/best-practices.mdfor production readiness
Polar Implementation
- Load
references/polar/overview.mdfor auth and concepts - Load
references/polar/products.mdfor product setup - Load
references/polar/checkouts.mdfor payment flows - Load
references/polar/webhooks.mdfor event handling - Use
scripts/polar-webhook-verify.jsfor webhook verification - Load
references/polar/benefits.mdif automating delivery - Load
references/polar/best-practices.mdfor 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.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/samhvw8/dot-claude/payment-integration">View payment-integration on skillZs</a>