Appearance

Free Trial ​

A free trial is a marketing strategy that allows customers to try a product or service for free for a limited time. This allows customers to experience the product or service before making a purchase decision. Free trials are commonly used by software companies, streaming services, and other subscription-based businesses to attract new customers and increase sales.

The Free Trial workflow with Creduse typically involves the following steps:

  • Add Credits: When a user signs up for a free trial, you can add a predefined amount of credits to their account using the /add endpoint. This allows the user to access your service during the trial period. For further details about the /add endpoint, please refer to the Add endpoint documentation.

  • Subtract Credits: As the user consumes your service or performs various actions, you subtract credits from their balance using the /subtract endpoint. This deduction reflects the usage or consumption of your service. For further details about the /subtract endpoint, please refer to the Subtract endpoint documentation.

  • End of trial: When the trial period ends, you can choose to convert the user to a paying customer by allowing them to start a subscription or prompt them to purchase a credit bundle to continue using your service.

Implementation ​

Step 1: Add Credits ​

To add credits to a user's account during a free trial, you can call the /add endpoint provided by Creduse. This endpoint allows you to add the predefined amount of credits to the user's account:

curl
curl https://api.creduse.com/add \
    -H "Authorization : Bearer $YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
        "end_user_id": "UUID",
        "amount": 100,
        "validity_days": 7
        }' \

In this example, we are adding 100 credits to the user's account with a validity period of 7 days. The user can use these credits to access your service during the trial period.

Step 2: Subtract Credits ​

As the user consumes your service or performs various actions during the free trial, you can subtract credits from their balance using the /subtract endpoint. This deduction reflects the usage or consumption of your service. For example, if a user consumes 10 credits, you can deduct them from their balance as follows:

curl
curl https://api.creduse.com/subtract \
    -H "Authorization : Bearer $YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
        "end_user_id": "UUID",
        "amount": 50,
        }

When the user's balance reaches zero, you can prompt them to start a subscription or purchase additional credit bundles to continue using your service.

Step 3: End of Trial ​

When the trial period ends, the user's credits will expire based on the validity period set during the credit addition. They will no longer be able to access your service unless they start a subscription or purchase additional credits. You can guide the user through the process of converting to a paying customer by providing them with options to continue using your service.