# Subscription trial

> Learn how to configure and manage subscription trials, allowing you to offer free or discounted periods to attract and convert new customers.

Antom provides subscription trials that allows buyers to try Antom products or services for a limited time at no cost or at a discounted price before officially purchasing a subscription plan.

Through the trial, buyers can explore the actual features and performance of the product or service without bearing the full cost. Antom enables merchants to flexibly set trial periods (such as 7 days or 30 days) and discounted first‑month prices based on your product characteristics, helping you efficiently conduct tiered marketing and acquire customers with greater precision.

## User experience

Antom provides a comprehensive subscription trial experience. The following illustrations show the user experience on both PC and mobile devices:

#### Tab: PC

![Subscription trial checkout experience on desktop that shows the merchant checkout page](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/1768373610270-073fd091-292d-4313-9219-c64f055b9801.png)

巴MERCHANT

四MERCHANT

日ANTOM

WALLET

HKD 8.00

HKD 8.00

14M8.00

#### Tab: Mobile

![Subscription trial checkout experience on mobile that shows the mobile-optimized checkout page](https://idocs-assets.marmot-cloud.com/storage/idocs87c36dc8dac653c1/1768373681360-17af5d62-0e0c-415e-933c-d40741e25d57.png)

四MERCHANT

WALLET

ARNTOM

MERCHANT

16.09

支付成功

付款样帽

安杭成功

HKD8

南川菜

HKD 8.00

HKD 8.00

M 8.00

全通付款

村战方式

1M

指识

8

0

SINE HNIAN

HKD27

## Activate subscription trial

When a buyer wants to activate a subscription trial, you need to specify the _subscriptionStartTime_ parameter through the [**create**](https://docs.antom.com/ac/ams_zh-cn/create_sub.md) API. The value of this parameter should be the trial end time minus the length of one billing period.

At the same time, set _trialAmount.value_ (the amount for one period) to `0` or a value greater than 0. For example, if the current time is 2025‑03‑12, and a 7‑day free trial is configured, then _subscriptionStartTime_ should be set to 2025‑02‑19T16:15:29+08:00.

> **Note:**
>
> -   The duration of the free trial cannot exceed the length of one billing period.
> -   The value of _subscriptionStartTime_ must follow the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) standard format, for example: "2019-11-27T12:01:01+08:00".

After successful configuration, the value will take effect based on the specified date and time. Please refer to the example code below:

```json
{
 ...............

  "subscriptionInfo": {
    "subscriptionNotifyUrl": "https://www.yourwebsite.com/app/notifySuccess",
    "subscriptionStartTime": "2025-02-19T16:15:29+08:00",
    "subscriptionDescription": "Subscription",
    "periodRule": {
      "periodType": "MONTH",
      "periodCount": 1
    },
    "trials": [{
      "trialStartPeriod": 1,
      "trialAmount": {
        "currency": "USD",
        "value": "0"
      },
      "trialEndPeriod": 1
    }]
  },
}

```

[Apple Pay](https://docs.antom.com/ac/antomop/applepay.md), [Google Pay](https://docs.antom.com/ac/antomop/googlepay.md), and card payments do not support zero-amount transactions. If buyers using these payment methods wish to start a free trial, they can follow the steps below:

1.  Set the trial amount to the minimum value, for example, set _trialAmount.value_ to `100`. Please refer to the example code below:

```json
{
 ...............



  "subscriptionInfo": {
    "subscriptionNotifyUrl": "https://www.yourwebsite.com/app/notifySuccess",
    "subscriptionStartTime": "2025-02-19T16:15:29+08:00",
    "subscriptionDescription": "Subscription",
    "periodRule": {
      "periodType": "MONTH",
      "periodCount": 1
    },
    "trials": [{
      "trialStartPeriod": 1,
      "trialAmount": {
        "currency": "USD",
        "value": "100"
      },
      "trialEndPeriod": 1
    }]
  },
}

```

2.  After the payment is successful, call the [**refund**](https://docs.antom.com/ac/ams/refund_online.md) API to issue a refund for this order.