payment-integration_skill

Overview

This skill integrates payments with SePay (Vietnamese bank transfers, VietQR) and Polar (global SaaS subscriptions and billing). It provides authentication, checkout flows, webhook handling, QR code generation, and subscription/usage billing patterns to power checkout and post-purchase automation. Use it to implement secure, tested payment flows for both local Vietnam and global SaaS markets.

How this skill works

The skill exposes integration recipes and code samples for each platform: auth setup, API/SDK usage, product and pricing configuration, checkout session creation, and webhook verification. It guides you through SePay-specific features (VietQR, virtual accounts, bank monitoring) and Polar capabilities (subscriptions, usage meters, Merchant of Record, automated benefits), plus verification scripts and recommended workflows for testing and production.

When to use it

• Building checkout flows for Vietnamese customers using VND, VietQR, or bank transfers
• Launching global SaaS subscriptions with trials, upgrades, and billing via Polar
• Implementing webhook handlers for payment notifications and signature verification
• Automating delivery of benefits (licenses, GitHub/Discord roles) after payment
• Implementing usage-based billing, metering events, or customer portals for self-service management

Best practices

• Select the platform by market: SePay for Vietnam-specific payment methods, Polar for global subscriptions and MoR
• Use SDKs and provided verification scripts to validate webhooks and avoid fraudulent events
• Model products and pricing to match business logic: recurring plans, usage meters, or one-time purchases
• Test end-to-end in sandbox environments and rehearse failure and retry scenarios
• Monitor rate limits and implement exponential backoff; instrument analytics for payment success and churn

Example use cases

• Checkout for a Vietnamese e-commerce site accepting VietQR and bank transfers with SePay webhook reconciliation
• SaaS subscription management with Polar: free trial, upgrade path, usage billing, and Merchant of Record handling
• Automated post-payment entitlement: issue licenses, add GitHub/Discord roles, or deliver files after confirmed payment
• Customer portal where users view invoices, manage subscriptions, and update payment methods
• Hybrid deployment: SePay for local payments and Polar for international customers, sharing order state and entitlements