polar-testing

Configure Polar sandbox environments and test payment workflows with Stripe test cards.

255|42|Updated Nov 16, 2023
One-click install
npx skills add https://github.com/chmonitor/chmonitor --skill polar-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: polar-testing
Source: https://github.com/chmonitor/chmonitor/tree/main/.agents/skills/polar-testing
Command: npx skills add https://github.com/chmonitor/chmonitor --skill polar-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about polar-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test Polar payment integration without risking real charges?

To test Polar payment integration safely, configure a fully isolated sandbox environment with separate access tokens to prevent real financial transactions and production data corruption.

What Stripe test cards should I use to simulate failed Polar checkout flows?

Use pre-defined Stripe test card numbers to simulate successful transactions, generic declines, insufficient funds, expired cards, and 3D Secure authentication flows within your Polar sandbox.

Can I debug Polar webhooks locally using ngrok?

Yes, you can expose your local development server with ngrok to test Polar webhook handlers, validate webhook signatures, and process real sandbox payloads during local webhook debugging.

Does this provide SDK mocking examples for Polar integration tests?

Yes, it provides ready-to-use code snippets for SDK mocking in unit tests and integration tests covering checkout flows, webhook signature validation, and license key checks across TypeScript, Python, and Go.

How do I run automated Polar payment tests in a CI/CD pipeline?

Automate Polar payment tests by integrating a pre-written GitHub Actions workflow template that runs your integration test suite on every code push or pull request.

What is the best way to test a Polar subscription cancellation and benefit granting flow?

The best way is using the Polar sandbox to test the entire user journey from checkout to subscription cancellation and benefit granting, ensuring your billing logic works without processing real payments.