Troubleshooting

Subscription Not Created

Symptoms: Checkout completes successfully, but no subscription record appears in the dashboard or API.

Possible Causes & Solutions:

Cause	Recommended Action
Missing or malformed `recurring` object	Ensure the recurring object follows the documented structure and contains valid fields.
Feature not enabled	Confirm Recurring Payments are enabled in store settings.
Gateway transaction failed	Review payment gateway logs for declined or incomplete transactions.

Subscription not creating

Verify the app_id matches your Partner Portal application ID and all required parameters are present.

Button text not updating

Check that the hook is targeting the correct component and product ID.

Developer Tip

Use webhook logs (subscription.created) to confirm whether a subscription event was generated for the checkout.