---
title: "Verify a sandbox trial converts to one paid subscription"
description: "Convert a test organization trial to a paid plan and check entitlement activation, renewal details, and one matching sandbox billing record."
canonical_url: "https://vostride.com/agent-library/billing-subscriptions/trial-to-paid-conversion.md"
md_url: "https://vostride.com/agent-library/billing-subscriptions/trial-to-paid-conversion.md"
content_kind: "recipe"
topic: "billing-subscriptions"
---

# Verify a sandbox trial converts to one paid subscription

Convert a test organization trial to a paid plan and check entitlement activation, renewal details, and one matching sandbox billing record.

## Risk

A paid-plan success page can render before payment or subscription state is durable. The test must connect the selected plan, sandbox payment outcome, product entitlements, and renewal schedule for the same billing customer.

## Fixtures

- A disposable organization on an active trial with a known end timestamp.
- A sandbox payment customer and a provider-supported successful test payment method.
- Documented plan features and application hooks that inspect subscription state, entitlements, and sandbox invoice records.

## Steps

1. Open Billing as the authorized owner and verify the current trial plan, trial end date, and available paid plan price.
2. Choose the intended plan and verify currency, billing interval, quantity, and any trial-credit treatment before confirming.
3. Complete the sandbox payment flow once and verify the application reports the selected paid plan with a renewal date.
4. Open a feature restricted to the paid plan and perform a reversible fixture action; verify its result persists after reload.
5. Inspect subscription and invoice state through registered hooks and verify one active subscription, the correct customer and plan identifiers, and the documented initial charge or deferred charge.

## Expected results

- The organization receives the chosen paid plan and expected entitlement set.
- Billing records contain one intended subscription transition and the correct initial amount.
- The renewal date and trial treatment shown in the interface agree with stored subscription state.

## False-pass traps

- An upgrade success toast alone cannot establish payment settlement or entitlement persistence.
- A sandbox provider confirmation should be matched to the application customer and subscription, not merely counted globally.

## Cleanup

- Cancel the disposable sandbox subscription and delete resources created by the entitlement check.

## Use with agent-qa

Adapt this test design to your application's acceptance criteria and configured target using the [recipe execution guide](/agent-library/software-factory/turn-a-recipe-into-an-agent-qa-test.md). External fixture setup and non-UI checks require your own supported hooks or test tooling. Validate the authored test, execute it, and inspect the completed evidence; this recipe is not a recorded test result.

## References

- [agent-qa test](/docs/agent-qa/configuration/test.md)
- [agent-qa hooks](/docs/agent-qa/guides/hooks.md)
- [agent-qa auth state](/docs/agent-qa/guides/auth-state.md)

- [Billing and subscription QA recipes](/agent-library/billing-subscriptions.md)
- [Software factory QA library](/agent-library.md)