Cancel Subscription

DELETE {{baseUrl}}/v1/payments/subscriptions/:subscriptionId

Cancel a subscription.

Request Body

{"cancel_at_period_end"=>"<boolean>"}

HEADERS

KeyDatatypeRequiredDescription
Content-Typestring
Acceptstring

RESPONSES

status: OK

{&quot;data&quot;:{&quot;billing&quot;:&quot;\u003cstring\u003e&quot;,&quot;billing_cycle_anchor&quot;:&quot;\u003cstring\u003e&quot;,&quot;cancel_at_period_end&quot;:&quot;\u003cboolean\u003e&quot;,&quot;canceled_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;created_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;current_period_end&quot;:&quot;\u003cnumber\u003e&quot;,&quot;current_period_start&quot;:&quot;\u003cnumber\u003e&quot;,&quot;customer_token&quot;:&quot;\u003cstring\u003e&quot;,&quot;days_until_due&quot;:&quot;\u003cnumber\u003e&quot;,&quot;discount&quot;:{&quot;coupon&quot;:{&quot;amount_off&quot;:&quot;\u003cnumber\u003e&quot;,&quot;created&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;GTQ&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;discount_duration_in_uses&quot;:&quot;\u003cnumber\u003e&quot;,&quot;discount_valid_until&quot;:&quot;\u003cnumber\u003e&quot;,&quot;discount_validity_in_months&quot;:&quot;\u003cnumber\u003e&quot;,&quot;duration&quot;:&quot;repeating&quot;,&quot;duration_in_months&quot;:&quot;\u003cnumber\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;max_redemptions&quot;:&quot;\u003cnumber\u003e&quot;,&quot;metadata&quot;:{},&quot;percent_off&quot;:9,&quot;redeem_by&quot;:&quot;\u003cnumber\u003e&quot;,&quot;times_redeemed&quot;:&quot;\u003cnumber\u003e&quot;,&quot;valid&quot;:&quot;\u003cboolean\u003e&quot;},&quot;end&quot;:&quot;\u003cnumber\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;number_of_uses&quot;:&quot;\u003cnumber\u003e&quot;,&quot;start&quot;:&quot;\u003cnumber\u003e&quot;,&quot;subscription&quot;:&quot;\u003cstring\u003e&quot;,&quot;valid&quot;:&quot;\u003cboolean\u003e&quot;},&quot;ended_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata&quot;:{},&quot;payment_fields&quot;:{},&quot;payment_method&quot;:&quot;\u003cstring\u003e&quot;,&quot;payout_fields&quot;:{},&quot;simultaneous_invoice&quot;:&quot;\u003cboolean\u003e&quot;,&quot;status&quot;:&quot;active&quot;,&quot;subscription_items&quot;:{&quot;data&quot;:[{&quot;created&quot;:&quot;\u003cnumber\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata&quot;:{},&quot;plan&quot;:{&quot;active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;aggregate_usage&quot;:&quot;max&quot;,&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;billing_scheme&quot;:&quot;per_unit&quot;,&quot;created_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;TOP&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;interval&quot;:&quot;month&quot;,&quot;interval_count&quot;:&quot;\u003cnumber\u003e&quot;,&quot;metadata&quot;:{},&quot;nickname&quot;:&quot;\u003cstring\u003e&quot;,&quot;product&quot;:{&quot;active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;attributes&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;created_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;images&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;metadata&quot;:{},&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;package_dimensions&quot;:{&quot;height&quot;:&quot;\u003cnumber\u003e&quot;,&quot;length&quot;:&quot;\u003cnumber\u003e&quot;,&quot;weight&quot;:&quot;\u003cnumber\u003e&quot;,&quot;width&quot;:&quot;\u003cnumber\u003e&quot;},&quot;shippable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;skus&quot;:[{&quot;active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;attributes&quot;:{},&quot;created_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;COP&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;image&quot;:&quot;\u003cstring\u003e&quot;,&quot;inventory&quot;:{},&quot;metadata&quot;:{},&quot;package_dimensions&quot;:{&quot;height&quot;:&quot;\u003cnumber\u003e&quot;,&quot;length&quot;:&quot;\u003cnumber\u003e&quot;,&quot;weight&quot;:&quot;\u003cnumber\u003e&quot;,&quot;width&quot;:&quot;\u003cnumber\u003e&quot;},&quot;price&quot;:&quot;\u003cnumber\u003e&quot;,&quot;product&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cnumber\u003e&quot;},{&quot;active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;attributes&quot;:{},&quot;created_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;CHF&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;image&quot;:&quot;\u003cstring\u003e&quot;,&quot;inventory&quot;:{},&quot;metadata&quot;:{},&quot;package_dimensions&quot;:{&quot;height&quot;:&quot;\u003cnumber\u003e&quot;,&quot;length&quot;:&quot;\u003cnumber\u003e&quot;,&quot;weight&quot;:&quot;\u003cnumber\u003e&quot;,&quot;width&quot;:&quot;\u003cnumber\u003e&quot;},&quot;price&quot;:&quot;\u003cnumber\u003e&quot;,&quot;product&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cnumber\u003e&quot;}],&quot;statement_descriptor&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;goods&quot;,&quot;unit_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cnumber\u003e&quot;},&quot;tiers&quot;:[{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;flat_amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;up_to&quot;:&quot;\u003cstring\u003e&quot;},{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;flat_amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;up_to&quot;:&quot;\u003cstring\u003e&quot;}],&quot;tiers_mode&quot;:&quot;volume&quot;,&quot;transform_usage&quot;:{&quot;divide_by&quot;:&quot;\u003cnumber\u003e&quot;,&quot;round&quot;:&quot;\u003cstring\u003e&quot;},&quot;trial_period_days&quot;:&quot;\u003cnumber\u003e&quot;,&quot;usage_type&quot;:&quot;metered&quot;},&quot;quantity&quot;:&quot;\u003cnumber\u003e&quot;,&quot;subscription_id&quot;:&quot;\u003cstring\u003e&quot;},{&quot;created&quot;:&quot;\u003cnumber\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;metadata&quot;:{},&quot;plan&quot;:{&quot;active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;aggregate_usage&quot;:&quot;last_ever&quot;,&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;billing_scheme&quot;:&quot;per_unit&quot;,&quot;created_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;KRW&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;interval&quot;:&quot;month&quot;,&quot;interval_count&quot;:&quot;\u003cnumber\u003e&quot;,&quot;metadata&quot;:{},&quot;nickname&quot;:&quot;\u003cstring\u003e&quot;,&quot;product&quot;:{&quot;active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;attributes&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;created_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;description&quot;:&quot;\u003cstring\u003e&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;images&quot;:[&quot;\u003cstring\u003e&quot;,&quot;\u003cstring\u003e&quot;],&quot;metadata&quot;:{},&quot;name&quot;:&quot;\u003cstring\u003e&quot;,&quot;package_dimensions&quot;:{&quot;height&quot;:&quot;\u003cnumber\u003e&quot;,&quot;length&quot;:&quot;\u003cnumber\u003e&quot;,&quot;weight&quot;:&quot;\u003cnumber\u003e&quot;,&quot;width&quot;:&quot;\u003cnumber\u003e&quot;},&quot;shippable&quot;:&quot;\u003cboolean\u003e&quot;,&quot;skus&quot;:[{&quot;active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;attributes&quot;:{},&quot;created_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;BSD&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;image&quot;:&quot;\u003cstring\u003e&quot;,&quot;inventory&quot;:{},&quot;metadata&quot;:{},&quot;package_dimensions&quot;:{&quot;height&quot;:&quot;\u003cnumber\u003e&quot;,&quot;length&quot;:&quot;\u003cnumber\u003e&quot;,&quot;weight&quot;:&quot;\u003cnumber\u003e&quot;,&quot;width&quot;:&quot;\u003cnumber\u003e&quot;},&quot;price&quot;:&quot;\u003cnumber\u003e&quot;,&quot;product&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cnumber\u003e&quot;},{&quot;active&quot;:&quot;\u003cboolean\u003e&quot;,&quot;attributes&quot;:{},&quot;created_at&quot;:&quot;\u003cnumber\u003e&quot;,&quot;currency&quot;:&quot;IRR&quot;,&quot;id&quot;:&quot;\u003cstring\u003e&quot;,&quot;image&quot;:&quot;\u003cstring\u003e&quot;,&quot;inventory&quot;:{},&quot;metadata&quot;:{},&quot;package_dimensions&quot;:{&quot;height&quot;:&quot;\u003cnumber\u003e&quot;,&quot;length&quot;:&quot;\u003cnumber\u003e&quot;,&quot;weight&quot;:&quot;\u003cnumber\u003e&quot;,&quot;width&quot;:&quot;\u003cnumber\u003e&quot;},&quot;price&quot;:&quot;\u003cnumber\u003e&quot;,&quot;product&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cnumber\u003e&quot;}],&quot;statement_descriptor&quot;:&quot;\u003cstring\u003e&quot;,&quot;type&quot;:&quot;goods&quot;,&quot;unit_label&quot;:&quot;\u003cstring\u003e&quot;,&quot;updated_at&quot;:&quot;\u003cnumber\u003e&quot;},&quot;tiers&quot;:[{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;flat_amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;up_to&quot;:&quot;\u003cstring\u003e&quot;},{&quot;amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;flat_amount&quot;:&quot;\u003cnumber\u003e&quot;,&quot;up_to&quot;:&quot;\u003cstring\u003e&quot;}],&quot;tiers_mode&quot;:&quot;volume&quot;,&quot;transform_usage&quot;:{&quot;divide_by&quot;:&quot;\u003cnumber\u003e&quot;,&quot;round&quot;:&quot;\u003cstring\u003e&quot;},&quot;trial_period_days&quot;:&quot;\u003cnumber\u003e&quot;,&quot;usage_type&quot;:&quot;metered&quot;},&quot;quantity&quot;:&quot;\u003cnumber\u003e&quot;,&quot;subscription_id&quot;:&quot;\u003cstring\u003e&quot;}],&quot;has_more&quot;:&quot;\u003cboolean\u003e&quot;,&quot;total_count&quot;:&quot;\u003cnumber\u003e&quot;,&quot;url&quot;:&quot;\u003cstring\u003e&quot;},&quot;tax_percent&quot;:&quot;\u003cnumber\u003e&quot;,&quot;trial_end&quot;:&quot;\u003cnumber\u003e&quot;,&quot;trial_start&quot;:&quot;\u003cnumber\u003e&quot;,&quot;type&quot;:&quot;payment&quot;},&quot;status&quot;:{&quot;error_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;message&quot;:&quot;\u003cstring\u003e&quot;,&quot;operation_id&quot;:&quot;\u003cstring\u003e&quot;,&quot;response_code&quot;:&quot;\u003cstring\u003e&quot;,&quot;status&quot;:&quot;\u003cstring\u003e&quot;}}