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:
- Log into the Finix Dashboard .
- Click Billing > Subscriptions .
- Click Create Subscription
- 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:
-
Select a buyer you want to charge. This can be either a buyer, seller, or recipient
identity
. -
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 belinked_to
-
The
amount
andcurrency
of the subscription -
The
subscription_details
-
The
buyer_details
including both theidentity_id
andinstrument_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"
}
}
}