polar-testing

What problem does it solve?

Testing Polar payment integrations in production environments risks accidental real charges, corrupted customer data, and failed transactions that impact real users. This Skill eliminates that risk by providing a complete guide to using Polar's fully isolated sandbox environment for all testing needs.

Core Features & Use Cases

• Sandbox Environment Configuration: Step-by-step instructions to set up a separate sandbox account, organization, and access tokens completely isolated from Polar production.
• Comprehensive Test Card Library: Pre-defined Stripe test card numbers for all common payment scenarios, including successful transactions, generic declines, insufficient funds, expired cards, and 3D Secure authentication flows.
• Local Webhook Testing: Guidance for using ngrok to expose your local development server and test Polar webhook handlers with real sandbox payloads.
• Full Test Coverage Examples: Ready-to-use code snippets for integration tests (checkout flows, webhook signature validation, license key checks) and unit test mocks for the Polar SDK across TypeScript, Python, and Go.
• CI/CD Pipeline Integration: A pre-written GitHub Actions workflow template to run automated Polar integration tests on every code push or pull request.
• Real-World Use Case: For a SaaS startup building Polar-powered subscription billing, this Skill lets you test the entire user journey—from checkout to subscription cancellation and benefit granting—without processing real payments or touching production customer data.

Quick Start

Use the polar-testing skill to configure your Polar sandbox environment, run a test checkout flow with a valid test Visa card, and verify your webhook handler correctly processes an order.paid event from the sandbox.