Subscriptions

Note: This product is in early access and requires an additional fee. Please contact your Finix Point of Contact for pricing on this feature.

Subscriptions allow you to charge a fixed amount to payment_instrument on a recurring time period. You can use Subscriptions to charge buyers, customers, or even merchants.

Example use cases for Subscriptions:

• Charging buyers a recurring monthly fee to access a gym or health club
• Charging buyers an annual membership fee for services or goods rendered
• Charging merchants a monthly or annual fee for using your software

Supported Payment Methods

Subscriptions currently support:

• Recurring Card payments
• Recurring Bank account payments (ACH in USA)

For more details about ACH payments, see ACH Direct Debit.

Supported Time Periods

Finix supports the following time periods for Subscriptions:

• Daily
• Weekly
• Monthly
• Quarterly
• Yearly

When creating a Subscription, you can specify the billing_frequency.

Supported Countries

Subscriptions are available in the following countries:

• United States

Creating a Subscription on the Finix Dashboard

You can create a Subscription in the Finix Dashboard without any development work. Using the Finix Dashboard, you can:

• Create Subscriptions from existing buyers and payment_instruments
• View the existing Subscriptions
• Cancel a Subscription if a buyer or customer chooses to end their goods or services

Step 1: Navigate to Subscriptions

To create a Subscription in the Finix Dashboard:

1. Log into the Finix Dashboard .
2. Click Billing > Subscriptions .
3. Click Create Subscription
4. Fill out the form with the requested details.

Step 2. Create a Subscription

When you click on Create Subscription, a form will appear with the following options:

Billing Settings

This section specifies how you want to bill your buyers.

• Subscription Name
• Billing Frequency
• Recurring Price

Trial Phase

You can enter a trial phase if your Subscription requires a set number of days before charging the buyer. For example, a 30-day trial, 3-month trial, or other combinations are possible.

Select Buyer

When you create a Subscription, you'll need to:

1. Select a buyer you want to charge. This can be either a buyer, seller, or recipient identity .
2. Select the payment_instrument you want to bill.

Creating a Buyer and Payment Instrument

On the Create Subscription page, we allow you to create a buyer and a card payment_instrument.

If you would like to add a bank account on this page, you will need to use our API. If you require an exception, email our support team.

Review and Create Subscriptions

After filling out the previous section, you can create the Subscription.

Depending on whether there is a trial phase or not, the Subscription will create a Transfer shortly after creation. The initial Transfer will be created within 60 minutes of the Subscription creation.

Creating a Subscription via API

To create a Subscription, include:

• The ID of the Merchant that the subscription will be linked_to
• The amount and currency of the subscription
• The subscription_details
• The buyer_details including both the identity_id and instrument_id

At this time, only APPROVED Merchants with one of the following processors can create Subscriptions:

• DUMMY_V1
• FINIX_V1

For detailed API information, please see our Subscriptions API Reference

curl https://finix.sandbox-payments-api.com/subscriptions \
  -H 'Content-Type: application/json' \
  -H 'Finix-Version: 2022-02-01' \
  -u USksBJMwkNUz5GyxPevL2yFY:71b641c1-861d-435b-9a9c-532760731c5e \
  -X POST \
  -d '{
  "amount": 2900,
  "currency": "USD",
  "linked_to": "MUaC9hbNvRwBoCJzqrjWk69N",
  "nickname": "Test Subscription",
  "billing_interval": "MONTHLY",
  "subscription_details": {
    "collection_method": "BILL_AUTOMATICALLY",
    "trial_details": {
      "interval_type": "MONTH",
      "interval_count": "1"
    }
  },
  "buyer_details": {
    "identity_id": "ID2maTpthyAYJWnZ5kDD42Cd",
    "instrument_id": "PInE8utFwr4eoXdftZBQuxGw"
  }
}'

Response:

{
  "id" : "subscription_cd5brMYg6u1WuicGTbq1P",
  "created_at" : "2024-07-10T23:38:47.43Z",
  "updated_at" : "2024-07-10T23:38:47.43Z",
  "first_charge_at" : "2024-07-10T23:38:47.00Z",
  "amount" : 2900,
  "buyer_details" : {
    "identity_id" : "ID2maTpthyAYJWnZ5kDD42Cd",
    "instrument_id" : "PInE8utFwr4eoXdftZBQuxGw"
  },
  "currency" : "USD",
  "linked_to" : "MUaC9hbNvRwBoCJzqrjWk69N",
  "linked_type" : "MERCHANT",
  "nickname" : "Test Subscription",
  "billing_interval" : "MONTHLY",
  "subscription_details" : {
    "collection_method" : "BILL_AUTOMATICALLY",
    "send_invoice" : false,
    "send_receipt" : false,
    "trial_details" : {
      "interval_type" : "MONTH",
      "interval_count" : 1,
      "trial_started_at" : "2024-07-10T19:13:14.00Z",
      "trial_expected_end_at" : "2024-08-10T19:13:14.00Z"
    }
  },
  "subscription_phase" : "TRIAL",
  "state" : "ACTIVE",
  "subscription_plan_id" : null,
  "_links" : {
    "self" : {
      "href" : "https://finix.sandbox-payments-api.com/subscriptions/subscription_cd5brMYg6u1WuicGTbq1P"
    }
  }
}