Operations API
Subscriptions
tamio provides an array of billing tools to manage recurring payments, regardless of whether you're offering digital services, memberships, offline services, or physical product subscriptions subscriptions are initiated when customers are charged on a regular basis or with an installment plan key features include option to run subscriptions monthly, yearly, weekly, or daily trial periods can be added to billing plans, postponing credit card charges until trial completion trial periods can be manually extended if required subscriptions can be paused on demand to halt payment collection billing plans can be altered for a customer at any point customers are emailed automatically if a recurring charge fails, prompting them to update their credit card automated confirmation emails for 3d secure flows and sca regulations are fully supported subscription discounts can be offered on a one time basis, for a limited period, or for a lifetime these discounts can apply to all orders or can be redeemed via coupons and vouchers webhooks are supported subscription types every subscription comes with a corresponding subscription object docid\ k0wuvfe yqdvzc3q awny that houses information like products purchased, customer data, next billing date, and upcoming invoice details its type can be one of the following instalment a subscription of this type corresponds to an order paid via an instalment plan these instalments cannot be updated or have addons subscription a subscription of this type is created when a customer purchases a billing plan they can be updated at any point and addons can be incorporated throughout the billing cycle recurring invoice a subscription of this type is created when a customer pays for manually created invoices these invoices can be partially updated and addons can be added at any time during the billing cycle api endpoints description method url pause subscription docid\ o8tenbe0pps7q6af0jye2 post post /v2/subscriptions/pause/\ id resume subscription docid 6zt40jhvg 6vq4ga9ve5e post post /v2/subscriptions/resume/\ id update subscription docid 5deogcojzjqtwt4uaenrd post post /v2/subscriptions/update/\ id retrieve subscription docid\ yu4gqtkqgebaed4kvz2px get get /v2/subscriptions/retrieve/\ id create discount docid\ f4zsn6a1v 8ilgz2uqjqo post post /v2/subscriptions/discounts/create/\ id remove discount docid\ nsarmcouk14i wiidlwyl post post /v2/subscriptions/discounts/remove/\ id extend trial docid\ p08melcxk3fxmleeg99tt post post /v2/subscriptions/trial/extend/\ id end trial docid 4gszgbzo 1tadu6o ub8l post post /v2/subscriptions/trial/end/\ id cancel subscription docid\ skfhvnwvhub4dearequm post post /v2/subscriptions/cancel/\ id delete subscription docid\ b0ucuv5pwfomtudacd0o9 delete delete /v2/subscriptions/\ id bulk delete subscriptions docid\ jnwqsjdhs1yvkzc0hchae post post /v2/subscriptions/bulk/delete list all subscriptions docid\ q6zze mgebxxs6yg0o 8m get get /v2/subscriptions/list retrieve upgrades docid aplqgai2c tr d8p1yhn get get /v2/subscriptions/upgrades/\ id remove vat docid\ ctqf2pw5jxiiay1wvore4 post post /v2/subscriptions/vat/remove/\ id webhook events there are several webhook notification events associated with the subscriptions api subscription created subscription updated subscription renewed subscription payment failed subscription cancelled instalment completed you can see examples of notification events subscription events docid v9nhlsjkke9ztmipzzh8 subscription statuses status description active the subscription/instalment plan is active pending the subscription/instalment plan is awaiting payment from the customer past due the renewal payment for the current billing cycle has failed more payment retries will be attempted cancelled the subscription/instalment plan has been cancelled trialing the subscription is active, and the customer is on trial paused the subscription is paused, and payment collection is disabled cancel at period end the subscription will cancel at the end of the current billing period completed the instalment plan has been completed successfully payment methods subscriptions, instalments and all related features are available for merchants with stripe accounts if you haven't done so, visit your payments section inside your tamio dashboard and connect your stripe account currency supported gateways eur credit cards, ideal, sepa, bancontact, sofort all the rest credit cards permissions whether managing teammates or creating api developer keys, you can customise permissions when accessing subscriptions api resources the default set of subscription permissions are view , edit and remove