Subscription trial

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:

Activate subscription trial

When a buyer wants to activate a subscription trial, you need to specify the subscriptionStartTime parameter through the create 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 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:

{
 ...............
  
  "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, Google Pay, 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:

{
 ...............

 
  
  "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 API to issue a refund for this order.