Set Up Billing

Billing connects your plans to a payment provider so customers can pay for subscriptions. GrabWP WaaS supports Polar (primary) and WooCommerce (alternative).

This guide covers Polar. For WooCommerce, see WooCommerce Billing.

Navigate to WaaS → Settings → Billing (/wp-admin/admin.php?page=grabwp-tenancy-waas-settings&tab=billing).

Step 1: Create a Polar Account

1. Go to polar.sh and create an account
2. Create an Organization if you don't have one
3. Note your organization dashboard URL — you'll need it

Step 2: Create Products in Polar

For each paid plan, create a matching product in Polar.

1. In Polar dashboard, go to Products
2. Click Create Product
3. Set up your product:

Field	Value
Name	Same as your plan name (e.g., "Pro Monthly")
Type	Subscription
Price	Must match your plan price (e.g., $9.99/month)
Billing Interval	Monthly (or Yearly for yearly products)

4. After creating the product, copy its Product ID (UUID) from the product settings page

Create separate products for monthly and yearly billing. For example: "Pro Monthly" ($9.99/month) and "Pro Yearly" ($99.99/year).

Step 3: Configure Polar in WaaS

On the Billing Providers tab:

1. Find the Polar provider card
2. Check Enable this provider
3. Fill in:

Field	Description
API URL	https://api.polar.sh (production) or https://sandbox-api.polar.sh (testing)
Access Token	Your Polar API token — generate in Polar → Settings → API
Webhook Secret	Secret string to verify webhook authenticity

4. Click Save Settings

Step 4: Set Up Webhook

WaaS needs to receive payment events from Polar to activate subscriptions.

1. In Polar dashboard, go to Webhooks
2. Click Add Endpoint
3. Set the URL to:

   https://yoursaas.com/wp-json/grabwp-waas/v1/webhooks/billing/polar

4. Select events to send:
   • subscription.created
   • subscription.updated
   • subscription.canceled
   • order.created
5. Copy the Webhook Secret and paste it into WaaS → Settings → Billing → Polar → Webhook Secret
6. Save both Polar and WaaS settings

Test webhooks: Use the Polar dashboard → Webhooks → Delivery log to verify events are being received. Check WaaS → Settings → Billing → "Last webhook received" timestamp.

Step 5: Link Products to Plans

Go back to WaaS → Settings → Plans and edit your paid plan:

1. Paste the Polar Monthly Product ID into the matching field
2. Paste the Polar Yearly Product ID if you created a yearly product
3. Save the plan

Step 6: Test a Payment

Before going live, test the full payment flow:

1. Set Polar API URL to the sandbox endpoint: https://sandbox-api.polar.sh
2. Create sandbox products in the Polar sandbox dashboard
3. Go through the signup flow on your site, select the paid plan
4. Complete payment using Polar's sandbox test cards
5. Verify the tenant site is provisioned and subscription is active in WaaS → Subscriptions

Once verified, switch back to the production API URL and production products.

---

Next: Set Up Templates