Learn how to create a subscription with a discount in the trial period. We assume that you are familiar with the BillPro UI and you have completed the basic tutorials to get started and create an order with the BillPro API.

All merchants can Integrate with payment links or if you are a CardCorp merchant you can also Integrate with custom checkout and payment iframe.

In the UI, create a discount to apply to your trial period. The calculation of the trial price will be trial price = regular price - discount
See https://docs.bill.pro/docs/create-product-groups-and-pricing-elements#create-discounts
In the UI, create a subscription product. For the Price, enter your regular price and for the Discount, select your trial discount. Select the option to Apply discount to the initial payment only.
See https://docs.bill.pro/docs/create-a-subscription-product
Create a customer with the UI, or API, or use the CSV upload.
For the UI, see https://docs.bill.pro/docs/create-customers
For the API, see https://docs.bill.pro/reference/create-customer

Create a subscription order in the API

See https://docs.bill.pro/reference/create-subscription-order

curl --request POST \  
     --url 'https://test.bill.pro/api/v1/orders/create_subscription_order' \
     --header 'Authorization: Bearer <<apiKey>>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "order": {
    "currency": "EUR",
    "customer_id": 307,
    "invoice_id": "MyInvoiceID",
    "recurring_collection_interval": "MONTH",
    "start_date": "17/07/2024 14:00",
    "start_date_unix": "",
    "redirect_url": "https://success.example.com/",
    "failed_redirect_url": "https://failed.example.com/",
    "note": "Test subscription",
    "create_checkout": true,
    "order_product": {
      "product_id": 156
    }
  }
}'

Accept the initial payment via payment link or custom checkout (CardCorp merchants only). If you are integrating with payment links, then you need to display or send the payment link to the customer.
- See https://docs.bill.pro/reference/integrate-with-payment-links
- See https://docs.bill.pro/reference/integrate-with-custom-checkout-and-payment-iframe

Get the billing events of the order from the scheduled payments endpoint for the order.
- See https://docs.bill.pro/reference/list-scheduled-payments
  - In a subscription there is one event that is scheduled at the end of the first billing cycle. You will need the ID of the scheduled payment for the next step.
    curl --request GET \ --url 'https://test.bill.pro/api/v1/orders/<<order_id>>/scheduled_payments' --header 'Authorization: Bearer <<apiKey>>' \ --header 'accept: application/json' \ --header 'content-type: application/json'

Modify the scheduled payment to adjust the date of the next billing event to the end of the trial period. This will be the new billing date for future payments.

See https://docs.bill.pro/reference/update-scheduled-payment

curl --request PUT \  
     --url 'https://test.bill.pro/api/v1/orders/<<order_id>>/scheduled_payments/<<spid>>' \
     --header 'Authorization: Bearer <<apiKey>>' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "scheduled_payment": {
    "scheduled_at": "2024-07-19T14:00:00.000Z",
    "status": "scheduled"
  }
}
'