Overview

InTandem provides flexible billing flow integrations for its platform, empowering partners to incorporate their billing systems seamlessly. This approach allows partners to control the billing process while leveraging inTandem's robust subscription management capabilities.

By handling subscriptions through inTandem, partners can focus on managing the financial transactions and billing cycles with their preferred systems, ensuring a cohesive and efficient billing experience for users.

Glossary

• Product - A defined features set or service within the platform designed to provide value and to meet specific customer needs. For example - Core CRM Modules, Quickbook app, 250 SMS monthly quota.
• Offering - A commercial agreement enabling inTandem's businesses to make purchases under specified terms. For Example - Platinum Subscription, Quickbook app.
• Directory Offering - An assignment of an offering to a specific directory thus allowing that directory to offer the product to its businesses.
• Bundled Offering - A list of offerings granted for free as part of the parent offering.
• Subscription - A record describing a purchased product for a specific business and its commercial terms.

Subscription States

InTandem subscriptions are structured to exist in one of three states:

• Purchased - This is the initial status upon subscription creation, signifying that the business has earned the rights to the subscription's assets, whether through direct payment or as part of a bundle with another subscription.
• Canceled - A cancel request was sent. The package is still available until expriration_date date reaches.
• Expired - This status indicates that the business's rights to the subscription's assets have ceased, either due to the cancellation of the subscription or the completion of a dunning process.

Retrieving the business's subscriptions

when creating a business using the Create Business API, inTandem automatically sets the business up with a default subscription in its Subscriptions Manager. This subscription is accessible to the business, inTandem, and future apps that the user installs (and consent). The subscriptions, and any other subscription the business acquires, can be retrieved using the Get Subscriptions API.

An example of how to get the business's subscriptions:

curl --location --globoff 'https://api.vcita.biz/v3/license/subscriptions' \
--header 'Authorization: Bearer {Business token}' \
--header 'Content-Type: application/json' \

The above call response:

{
    "data": {
        "subscriptions": [
            {
                "uid": "eccb40d6-1a87-4309-8eaf-f432ab632213",
                "display_name": "CORE",
                "buyer_uid": "kjf28e3yuvvhdqxc",
                "business_uid": "uhjm033vsgtk732jn",
                "purchase_currency": "USD",
                "purchase_price": "0.00",
                "purchase_state": "expired",
                "cancellation_date": "2024-05-22T08:20:37.000Z",
                "expiration_date": "2024-05-22T08:20:37.000Z",
                "updated_at": "2025-01-22T09:09:07.286Z",
                "created_at": "2024-05-21T04:43:53.509Z",
                "payment_type": "free",
                "bundled_from_subscription_uid": null,
                "is_active": false,
                "offering_uid": "e5bd68ba-694e-49fe-b9df-f66bb3baa570",
                "trial_type": "no_trial",
                "offering_type": "package"
            }
        ]
    },
    "success": true
}