Test and troubleshoot Polar

Start with the shared payment testing setup, then use the Polar-specific connection and attribution checks below.

Connection checklist

In Polar, create an Organization Access Token for the correct organization with these permissions:

• Checkout Read;
• Orders Read;
• Organization Read;
• Products Read;
• Subscription Read;
• Webhook Write.

In Website settings → Revenue → Polar, paste the token, then select Connect Polar. Talivia detects the token's organization and whether it belongs to production or sandbox, validates every permission, creates the signed webhook, imports the previous 30 days of orders, and syncs subscription state.

You do not need to copy a webhook secret or create an OAuth application.

End-to-end test

1. Create a separate Talivia website and connect a Polar Sandbox organization there.
2. Open checkout from a tracked browser session.
3. Complete an order with Polar's sandbox payment flow.
4. Confirm the payment appears in Talivia with provider Polar.
5. Open the payment and verify its session, source, entry page, and amount.
6. Create a refund in Polar and confirm the same payment's refunded amount is updated.

Payment is unattributed

For Checkout API, inspect the created checkout and confirm metadata.talivia_session_id equals the value returned by window.talivia.getSessionId().

For Checkout Links and Embedded Checkout, confirm the Polar success URL is a tracked page and contains:

checkout_id={CHECKOUT_ID}

For subscriptions or custom flows, confirm Polar's customer external_id matches the externalCustomerId sent to window.talivia.identify.

Connection fails

• Organization not found: confirm the token has Organization Read and was created as an Organization Access Token.
• Permission error: recreate or update the token with every permission in the checklist.
• Webhook error: confirm Webhook Write is enabled and reconnect; Talivia will repair or recreate its endpoint.
• Production versus sandbox: Talivia detects the environment from the token automatically. Keep sandbox and production in separate Talivia websites so their revenue is not mixed.