[{"data":1,"prerenderedAt":1335},["ShallowReactive",2],{"navigation_docs":3,"-guides-subscriptions":132,"-guides-subscriptions-surround":1330},[4,30,47,128],{"title":5,"path":6,"stem":7,"children":8,"page":29},"Getting Started","\u002Fgetting-started","1.getting-started",[9,13,17,21,25],{"title":10,"path":11,"stem":12},"Introduction","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":14,"path":15,"stem":16},"Quickstart","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F2.quickstart",{"title":18,"path":19,"stem":20},"Authentication","\u002Fgetting-started\u002Fauthentication","1.getting-started\u002F3.authentication",{"title":22,"path":23,"stem":24},"Self-Hosting","\u002Fgetting-started\u002Fself-hosting","1.getting-started\u002F4.self-hosting",{"title":26,"path":27,"stem":28},"Build an Integration","\u002Fgetting-started\u002Fbuild-an-integration","1.getting-started\u002F5.build-an-integration",false,{"title":31,"path":32,"stem":33,"children":34,"page":29},"Sdks","\u002Fsdks","2.sdks",[35,39,43],{"title":36,"path":37,"stem":38},"TypeScript SDK","\u002Fsdks\u002Ftypescript","2.sdks\u002F1.typescript",{"title":40,"path":41,"stem":42},"Python SDK","\u002Fsdks\u002Fpython","2.sdks\u002F2.python",{"title":44,"path":45,"stem":46},"PHP SDK","\u002Fsdks\u002Fphp","2.sdks\u002F3.php",{"title":48,"path":49,"stem":50,"children":51,"page":29},"Guides","\u002Fguides","3.guides",[52,56,60,64,68,72,76,80,84,88,92,96,100,104,108,112,116,120,124],{"title":53,"path":54,"stem":55},"Customers","\u002Fguides\u002Fcustomers","3.guides\u002F1.customers",{"title":57,"path":58,"stem":59},"Usage-Based Billing","\u002Fguides\u002Fusage-billing","3.guides\u002F10.usage-billing",{"title":61,"path":62,"stem":63},"Wallets","\u002Fguides\u002Fwallets","3.guides\u002F11.wallets",{"title":65,"path":66,"stem":67},"Coupons, Add-ons and Credit Notes","\u002Fguides\u002Fcoupons-add-ons-credit-notes","3.guides\u002F12.coupons-add-ons-credit-notes",{"title":69,"path":70,"stem":71},"Taxes","\u002Fguides\u002Ftaxes","3.guides\u002F13.taxes",{"title":73,"path":74,"stem":75},"Customer Portal","\u002Fguides\u002Fcustomer-portal","3.guides\u002F14.customer-portal",{"title":77,"path":78,"stem":79},"Ledger","\u002Fguides\u002Fledger","3.guides\u002F15.ledger",{"title":81,"path":82,"stem":83},"Plan Limits and Access","\u002Fguides\u002Fplan-limits-and-access","3.guides\u002F16.plan-limits-and-access",{"title":85,"path":86,"stem":87},"Currencies and Exchange Rates","\u002Fguides\u002Fcurrencies","3.guides\u002F17.currencies",{"title":89,"path":90,"stem":91},"Charge a Customer","\u002Fguides\u002Fcharge-a-customer","3.guides\u002F18.charge-a-customer",{"title":93,"path":94,"stem":95},"One-time Products & Partial Payments","\u002Fguides\u002Fone-time-products-and-partial-payments","3.guides\u002F19.one-time-products-and-partial-payments",{"title":97,"path":98,"stem":99},"Plans & Pricing","\u002Fguides\u002Fplans-and-pricing","3.guides\u002F2.plans-and-pricing",{"title":101,"path":102,"stem":103},"Subscriptions","\u002Fguides\u002Fsubscriptions","3.guides\u002F3.subscriptions",{"title":105,"path":106,"stem":107},"Invoices & Payments","\u002Fguides\u002Finvoices-and-payments","3.guides\u002F4.invoices-and-payments",{"title":109,"path":110,"stem":111},"Payment Providers","\u002Fguides\u002Fpayment-providers","3.guides\u002F5.payment-providers",{"title":113,"path":114,"stem":115},"Analytics","\u002Fguides\u002Fanalytics","3.guides\u002F6.analytics",{"title":117,"path":118,"stem":119},"Webhooks","\u002Fguides\u002Fwebhooks","3.guides\u002F7.webhooks",{"title":121,"path":122,"stem":123},"Sandbox","\u002Fguides\u002Fsandbox","3.guides\u002F8.sandbox",{"title":125,"path":126,"stem":127},"Money Movement","\u002Fguides\u002Fmoney-movement","3.guides\u002F9.money-movement",{"title":129,"path":130,"stem":131},"API Reference","\u002Fapi-reference","4.api-reference",{"id":133,"title":101,"body":134,"description":1324,"extension":1325,"links":1326,"meta":1327,"navigation":308,"path":102,"seo":1328,"stem":103,"__hash__":1329},"docs\u002F3.guides\u002F3.subscriptions.md",{"type":135,"value":136,"toc":1312},"minimark",[137,141,146,157,161,563,567,759,763,904,908,913,985,989,1060,1064,1235,1239,1308],[138,139,140],"p",{},"Subscriptions link customers to plans and manage the billing lifecycle automatically.",[142,143,145],"h2",{"id":144},"subscription-lifecycle","Subscription Lifecycle",[147,148,153],"pre",{"className":149,"code":151,"language":152},[150],"language-text","TRIALING → ACTIVE → PAUSED → ACTIVE → CANCELED\n                  → PAST_DUE → ACTIVE (after retry)\n                              → CANCELED (after max retries)\n","text",[154,155,151],"code",{"__ignoreMap":156},"",[142,158,160],{"id":159},"create-a-subscription","Create a Subscription",[162,163,165,267,498],"code-group",{"sync":164},"lang",[147,166,171],{"className":167,"code":168,"filename":169,"language":170,"meta":156,"style":156},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -X POST http:\u002F\u002Flocalhost:4000\u002Fapi\u002Fsubscriptions \\\n  -H \"Authorization: Bearer sk_live_a1b2c3d4...\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"customerId\": \"cust_x1y2z3\",\n    \"planId\": \"plan_abc123\",\n    \"currency\": \"UGX\"\n  }'\n","cURL","bash",[154,172,173,196,214,228,240,246,252,258],{"__ignoreMap":156},[174,175,178,182,186,189,192],"span",{"class":176,"line":177},"line",1,[174,179,181],{"class":180},"sBMFI","curl",[174,183,185],{"class":184},"sfazB"," -X",[174,187,188],{"class":184}," POST",[174,190,191],{"class":184}," http:\u002F\u002Flocalhost:4000\u002Fapi\u002Fsubscriptions",[174,193,195],{"class":194},"sTEyZ"," \\\n",[174,197,199,202,206,209,212],{"class":176,"line":198},2,[174,200,201],{"class":184},"  -H",[174,203,205],{"class":204},"sMK4o"," \"",[174,207,208],{"class":184},"Authorization: Bearer sk_live_a1b2c3d4...",[174,210,211],{"class":204},"\"",[174,213,195],{"class":194},[174,215,217,219,221,224,226],{"class":176,"line":216},3,[174,218,201],{"class":184},[174,220,205],{"class":204},[174,222,223],{"class":184},"Content-Type: application\u002Fjson",[174,225,211],{"class":204},[174,227,195],{"class":194},[174,229,231,234,237],{"class":176,"line":230},4,[174,232,233],{"class":184},"  -d",[174,235,236],{"class":204}," '",[174,238,239],{"class":184},"{\n",[174,241,243],{"class":176,"line":242},5,[174,244,245],{"class":184},"    \"customerId\": \"cust_x1y2z3\",\n",[174,247,249],{"class":176,"line":248},6,[174,250,251],{"class":184},"    \"planId\": \"plan_abc123\",\n",[174,253,255],{"class":176,"line":254},7,[174,256,257],{"class":184},"    \"currency\": \"UGX\"\n",[174,259,261,264],{"class":176,"line":260},8,[174,262,263],{"class":184},"  }",[174,265,266],{"class":204},"'\n",[147,268,273],{"className":269,"code":270,"filename":271,"language":272,"meta":156,"style":156},"language-typescript shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { PimaBillClient } from 'pimabill';\n\nconst client = new PimaBillClient({ token: 'sk_live_a1b2c3d4...' });\n\nconst subscription = await client.subscriptions.create({\n  customerId: 'cust_x1y2z3',\n  planId: 'plan_abc123',\n  currency: 'UGX'\n});\n\nconsole.log(subscription.id);     \u002F\u002F sub_...\nconsole.log(subscription.status); \u002F\u002F \"ACTIVE\"\n","TypeScript","typescript",[154,274,275,304,310,355,359,389,406,422,436,446,451,477],{"__ignoreMap":156},[174,276,277,281,284,287,290,293,295,298,301],{"class":176,"line":177},[174,278,280],{"class":279},"s7zQu","import",[174,282,283],{"class":204}," {",[174,285,286],{"class":194}," PimaBillClient",[174,288,289],{"class":204}," }",[174,291,292],{"class":279}," from",[174,294,236],{"class":204},[174,296,297],{"class":184},"pimabill",[174,299,300],{"class":204},"'",[174,302,303],{"class":204},";\n",[174,305,306],{"class":176,"line":198},[174,307,309],{"emptyLinePlaceholder":308},true,"\n",[174,311,312,316,319,322,325,328,331,334,338,341,343,346,348,350,353],{"class":176,"line":216},[174,313,315],{"class":314},"spNyl","const",[174,317,318],{"class":194}," client ",[174,320,321],{"class":204},"=",[174,323,324],{"class":204}," new",[174,326,286],{"class":327},"s2Zo4",[174,329,330],{"class":194},"(",[174,332,333],{"class":204},"{",[174,335,337],{"class":336},"swJcz"," token",[174,339,340],{"class":204},":",[174,342,236],{"class":204},[174,344,345],{"class":184},"sk_live_a1b2c3d4...",[174,347,300],{"class":204},[174,349,289],{"class":204},[174,351,352],{"class":194},")",[174,354,303],{"class":204},[174,356,357],{"class":176,"line":230},[174,358,309],{"emptyLinePlaceholder":308},[174,360,361,363,366,368,371,374,377,380,382,385,387],{"class":176,"line":242},[174,362,315],{"class":314},[174,364,365],{"class":194}," subscription ",[174,367,321],{"class":204},[174,369,370],{"class":279}," await",[174,372,373],{"class":194}," client",[174,375,376],{"class":204},".",[174,378,379],{"class":194},"subscriptions",[174,381,376],{"class":204},[174,383,384],{"class":327},"create",[174,386,330],{"class":194},[174,388,239],{"class":204},[174,390,391,394,396,398,401,403],{"class":176,"line":248},[174,392,393],{"class":336},"  customerId",[174,395,340],{"class":204},[174,397,236],{"class":204},[174,399,400],{"class":184},"cust_x1y2z3",[174,402,300],{"class":204},[174,404,405],{"class":204},",\n",[174,407,408,411,413,415,418,420],{"class":176,"line":254},[174,409,410],{"class":336},"  planId",[174,412,340],{"class":204},[174,414,236],{"class":204},[174,416,417],{"class":184},"plan_abc123",[174,419,300],{"class":204},[174,421,405],{"class":204},[174,423,424,427,429,431,434],{"class":176,"line":260},[174,425,426],{"class":336},"  currency",[174,428,340],{"class":204},[174,430,236],{"class":204},[174,432,433],{"class":184},"UGX",[174,435,266],{"class":204},[174,437,439,442,444],{"class":176,"line":438},9,[174,440,441],{"class":204},"}",[174,443,352],{"class":194},[174,445,303],{"class":204},[174,447,449],{"class":176,"line":448},10,[174,450,309],{"emptyLinePlaceholder":308},[174,452,454,457,459,462,465,467,470,473],{"class":176,"line":453},11,[174,455,456],{"class":194},"console",[174,458,376],{"class":204},[174,460,461],{"class":327},"log",[174,463,464],{"class":194},"(subscription",[174,466,376],{"class":204},[174,468,469],{"class":194},"id)",[174,471,472],{"class":204},";",[174,474,476],{"class":475},"sHwdD","     \u002F\u002F sub_...\n",[174,478,480,482,484,486,488,490,493,495],{"class":176,"line":479},12,[174,481,456],{"class":194},[174,483,376],{"class":204},[174,485,461],{"class":327},[174,487,464],{"class":194},[174,489,376],{"class":204},[174,491,492],{"class":194},"status)",[174,494,472],{"class":204},[174,496,497],{"class":475}," \u002F\u002F \"ACTIVE\"\n",[147,499,504],{"className":500,"code":501,"filename":502,"language":503,"meta":156,"style":156},"language-python shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","from pimabill import PimaBillClient\n\nclient = PimaBillClient(token=\"sk_live_a1b2c3d4...\")\n\nsubscription = client.subscriptions.create(\n    customer_id=\"cust_x1y2z3\",\n    plan_id=\"plan_abc123\",\n    currency=\"UGX\"\n)\n\nprint(subscription.id)      # sub_...\nprint(subscription.status)  # \"ACTIVE\"\n","Python","python",[154,505,506,511,515,520,524,529,534,539,544,549,553,558],{"__ignoreMap":156},[174,507,508],{"class":176,"line":177},[174,509,510],{},"from pimabill import PimaBillClient\n",[174,512,513],{"class":176,"line":198},[174,514,309],{"emptyLinePlaceholder":308},[174,516,517],{"class":176,"line":216},[174,518,519],{},"client = PimaBillClient(token=\"sk_live_a1b2c3d4...\")\n",[174,521,522],{"class":176,"line":230},[174,523,309],{"emptyLinePlaceholder":308},[174,525,526],{"class":176,"line":242},[174,527,528],{},"subscription = client.subscriptions.create(\n",[174,530,531],{"class":176,"line":248},[174,532,533],{},"    customer_id=\"cust_x1y2z3\",\n",[174,535,536],{"class":176,"line":254},[174,537,538],{},"    plan_id=\"plan_abc123\",\n",[174,540,541],{"class":176,"line":260},[174,542,543],{},"    currency=\"UGX\"\n",[174,545,546],{"class":176,"line":438},[174,547,548],{},")\n",[174,550,551],{"class":176,"line":448},[174,552,309],{"emptyLinePlaceholder":308},[174,554,555],{"class":176,"line":453},[174,556,557],{},"print(subscription.id)      # sub_...\n",[174,559,560],{"class":176,"line":479},[174,561,562],{},"print(subscription.status)  # \"ACTIVE\"\n",[142,564,566],{"id":565},"list-subscriptions","List Subscriptions",[162,568,569,603,740],{"sync":164},[147,570,572],{"className":167,"code":571,"filename":169,"language":170,"meta":156,"style":156},"curl -X GET \"http:\u002F\u002Flocalhost:4000\u002Fapi\u002Fsubscriptions?status=ACTIVE&page=1&limit=20\" \\\n  -H \"Authorization: Bearer sk_live_a1b2c3d4...\"\n",[154,573,574,592],{"__ignoreMap":156},[174,575,576,578,580,583,585,588,590],{"class":176,"line":177},[174,577,181],{"class":180},[174,579,185],{"class":184},[174,581,582],{"class":184}," GET",[174,584,205],{"class":204},[174,586,587],{"class":184},"http:\u002F\u002Flocalhost:4000\u002Fapi\u002Fsubscriptions?status=ACTIVE&page=1&limit=20",[174,589,211],{"class":204},[174,591,195],{"class":194},[174,593,594,596,598,600],{"class":176,"line":198},[174,595,201],{"class":184},[174,597,205],{"class":204},[174,599,208],{"class":184},[174,601,602],{"class":204},"\"\n",[147,604,606],{"className":269,"code":605,"filename":271,"language":272,"meta":156,"style":156},"\u002F\u002F List all active subscriptions\nconst subs = await client.subscriptions.list({\n  status: 'ACTIVE',\n  page: 1,\n  limit: 20\n});\n\n\u002F\u002F Filter by customer\nconst customerSubs = await client.subscriptions.list({\n  customerId: 'cust_x1y2z3'\n});\n",[154,607,608,613,639,655,668,678,686,690,695,720,732],{"__ignoreMap":156},[174,609,610],{"class":176,"line":177},[174,611,612],{"class":475},"\u002F\u002F List all active subscriptions\n",[174,614,615,617,620,622,624,626,628,630,632,635,637],{"class":176,"line":198},[174,616,315],{"class":314},[174,618,619],{"class":194}," subs ",[174,621,321],{"class":204},[174,623,370],{"class":279},[174,625,373],{"class":194},[174,627,376],{"class":204},[174,629,379],{"class":194},[174,631,376],{"class":204},[174,633,634],{"class":327},"list",[174,636,330],{"class":194},[174,638,239],{"class":204},[174,640,641,644,646,648,651,653],{"class":176,"line":216},[174,642,643],{"class":336},"  status",[174,645,340],{"class":204},[174,647,236],{"class":204},[174,649,650],{"class":184},"ACTIVE",[174,652,300],{"class":204},[174,654,405],{"class":204},[174,656,657,660,662,666],{"class":176,"line":230},[174,658,659],{"class":336},"  page",[174,661,340],{"class":204},[174,663,665],{"class":664},"sbssI"," 1",[174,667,405],{"class":204},[174,669,670,673,675],{"class":176,"line":242},[174,671,672],{"class":336},"  limit",[174,674,340],{"class":204},[174,676,677],{"class":664}," 20\n",[174,679,680,682,684],{"class":176,"line":248},[174,681,441],{"class":204},[174,683,352],{"class":194},[174,685,303],{"class":204},[174,687,688],{"class":176,"line":254},[174,689,309],{"emptyLinePlaceholder":308},[174,691,692],{"class":176,"line":260},[174,693,694],{"class":475},"\u002F\u002F Filter by customer\n",[174,696,697,699,702,704,706,708,710,712,714,716,718],{"class":176,"line":438},[174,698,315],{"class":314},[174,700,701],{"class":194}," customerSubs ",[174,703,321],{"class":204},[174,705,370],{"class":279},[174,707,373],{"class":194},[174,709,376],{"class":204},[174,711,379],{"class":194},[174,713,376],{"class":204},[174,715,634],{"class":327},[174,717,330],{"class":194},[174,719,239],{"class":204},[174,721,722,724,726,728,730],{"class":176,"line":448},[174,723,393],{"class":336},[174,725,340],{"class":204},[174,727,236],{"class":204},[174,729,400],{"class":184},[174,731,266],{"class":204},[174,733,734,736,738],{"class":176,"line":453},[174,735,441],{"class":204},[174,737,352],{"class":194},[174,739,303],{"class":204},[147,741,743],{"className":500,"code":742,"filename":502,"language":503,"meta":156,"style":156},"subs = client.subscriptions.list(status=\"ACTIVE\", page=1, limit=20)\n\ncustomer_subs = client.subscriptions.list(customer_id=\"cust_x1y2z3\")\n",[154,744,745,750,754],{"__ignoreMap":156},[174,746,747],{"class":176,"line":177},[174,748,749],{},"subs = client.subscriptions.list(status=\"ACTIVE\", page=1, limit=20)\n",[174,751,752],{"class":176,"line":198},[174,753,309],{"emptyLinePlaceholder":308},[174,755,756],{"class":176,"line":216},[174,757,758],{},"customer_subs = client.subscriptions.list(customer_id=\"cust_x1y2z3\")\n",[142,760,762],{"id":761},"cancel-a-subscription","Cancel a Subscription",[162,764,765,826,895],{"sync":164},[147,766,768],{"className":167,"code":767,"filename":169,"language":170,"meta":156,"style":156},"curl -X POST http:\u002F\u002Flocalhost:4000\u002Fapi\u002Fsubscriptions\u002Fsub_j3k4l5\u002Fcancel \\\n  -H \"Authorization: Bearer sk_live_a1b2c3d4...\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"cancelAt\": \"period_end\"\n  }'\n",[154,769,770,783,795,807,815,820],{"__ignoreMap":156},[174,771,772,774,776,778,781],{"class":176,"line":177},[174,773,181],{"class":180},[174,775,185],{"class":184},[174,777,188],{"class":184},[174,779,780],{"class":184}," http:\u002F\u002Flocalhost:4000\u002Fapi\u002Fsubscriptions\u002Fsub_j3k4l5\u002Fcancel",[174,782,195],{"class":194},[174,784,785,787,789,791,793],{"class":176,"line":198},[174,786,201],{"class":184},[174,788,205],{"class":204},[174,790,208],{"class":184},[174,792,211],{"class":204},[174,794,195],{"class":194},[174,796,797,799,801,803,805],{"class":176,"line":216},[174,798,201],{"class":184},[174,800,205],{"class":204},[174,802,223],{"class":184},[174,804,211],{"class":204},[174,806,195],{"class":194},[174,808,809,811,813],{"class":176,"line":230},[174,810,233],{"class":184},[174,812,236],{"class":204},[174,814,239],{"class":184},[174,816,817],{"class":176,"line":242},[174,818,819],{"class":184},"    \"cancelAt\": \"period_end\"\n",[174,821,822,824],{"class":176,"line":248},[174,823,263],{"class":184},[174,825,266],{"class":204},[147,827,829],{"className":269,"code":828,"filename":271,"language":272,"meta":156,"style":156},"const canceled = await client.subscriptions.cancel('sub_j3k4l5', {\n  cancelAt: 'period_end', \u002F\u002F or 'now'\n});\n",[154,830,831,868,887],{"__ignoreMap":156},[174,832,833,835,838,840,842,844,846,848,850,853,855,857,860,862,865],{"class":176,"line":177},[174,834,315],{"class":314},[174,836,837],{"class":194}," canceled ",[174,839,321],{"class":204},[174,841,370],{"class":279},[174,843,373],{"class":194},[174,845,376],{"class":204},[174,847,379],{"class":194},[174,849,376],{"class":204},[174,851,852],{"class":327},"cancel",[174,854,330],{"class":194},[174,856,300],{"class":204},[174,858,859],{"class":184},"sub_j3k4l5",[174,861,300],{"class":204},[174,863,864],{"class":204},",",[174,866,867],{"class":204}," {\n",[174,869,870,873,875,877,880,882,884],{"class":176,"line":198},[174,871,872],{"class":336},"  cancelAt",[174,874,340],{"class":204},[174,876,236],{"class":204},[174,878,879],{"class":184},"period_end",[174,881,300],{"class":204},[174,883,864],{"class":204},[174,885,886],{"class":475}," \u002F\u002F or 'now'\n",[174,888,889,891,893],{"class":176,"line":216},[174,890,441],{"class":204},[174,892,352],{"class":194},[174,894,303],{"class":204},[147,896,898],{"className":500,"code":897,"filename":502,"language":503,"meta":156,"style":156},"canceled = client.subscriptions.cancel(\"sub_j3k4l5\", cancel_at=\"period_end\")  # or \"now\"\n",[154,899,900],{"__ignoreMap":156},[174,901,902],{"class":176,"line":177},[174,903,897],{},[142,905,907],{"id":906},"pause-and-resume","Pause and Resume",[909,910,912],"h3",{"id":911},"pause-a-subscription","Pause a Subscription",[162,914,915,943,976],{"sync":164},[147,916,918],{"className":167,"code":917,"filename":169,"language":170,"meta":156,"style":156},"curl -X POST http:\u002F\u002Flocalhost:4000\u002Fapi\u002Fsubscriptions\u002Fsub_j3k4l5\u002Fpause \\\n  -H \"Authorization: Bearer sk_live_a1b2c3d4...\"\n",[154,919,920,933],{"__ignoreMap":156},[174,921,922,924,926,928,931],{"class":176,"line":177},[174,923,181],{"class":180},[174,925,185],{"class":184},[174,927,188],{"class":184},[174,929,930],{"class":184}," http:\u002F\u002Flocalhost:4000\u002Fapi\u002Fsubscriptions\u002Fsub_j3k4l5\u002Fpause",[174,932,195],{"class":194},[174,934,935,937,939,941],{"class":176,"line":198},[174,936,201],{"class":184},[174,938,205],{"class":204},[174,940,208],{"class":184},[174,942,602],{"class":204},[147,944,946],{"className":269,"code":945,"filename":271,"language":272,"meta":156,"style":156},"await client.subscriptions.pause('sub_j3k4l5');\n",[154,947,948],{"__ignoreMap":156},[174,949,950,953,955,957,959,961,964,966,968,970,972,974],{"class":176,"line":177},[174,951,952],{"class":279},"await",[174,954,373],{"class":194},[174,956,376],{"class":204},[174,958,379],{"class":194},[174,960,376],{"class":204},[174,962,963],{"class":327},"pause",[174,965,330],{"class":194},[174,967,300],{"class":204},[174,969,859],{"class":184},[174,971,300],{"class":204},[174,973,352],{"class":194},[174,975,303],{"class":204},[147,977,979],{"className":500,"code":978,"filename":502,"language":503,"meta":156,"style":156},"client.subscriptions.pause(\"sub_j3k4l5\")\n",[154,980,981],{"__ignoreMap":156},[174,982,983],{"class":176,"line":177},[174,984,978],{},[909,986,988],{"id":987},"resume-a-subscription","Resume a Subscription",[162,990,991,1019,1051],{"sync":164},[147,992,994],{"className":167,"code":993,"filename":169,"language":170,"meta":156,"style":156},"curl -X POST http:\u002F\u002Flocalhost:4000\u002Fapi\u002Fsubscriptions\u002Fsub_j3k4l5\u002Fresume \\\n  -H \"Authorization: Bearer sk_live_a1b2c3d4...\"\n",[154,995,996,1009],{"__ignoreMap":156},[174,997,998,1000,1002,1004,1007],{"class":176,"line":177},[174,999,181],{"class":180},[174,1001,185],{"class":184},[174,1003,188],{"class":184},[174,1005,1006],{"class":184}," http:\u002F\u002Flocalhost:4000\u002Fapi\u002Fsubscriptions\u002Fsub_j3k4l5\u002Fresume",[174,1008,195],{"class":194},[174,1010,1011,1013,1015,1017],{"class":176,"line":198},[174,1012,201],{"class":184},[174,1014,205],{"class":204},[174,1016,208],{"class":184},[174,1018,602],{"class":204},[147,1020,1022],{"className":269,"code":1021,"filename":271,"language":272,"meta":156,"style":156},"await client.subscriptions.resume('sub_j3k4l5');\n",[154,1023,1024],{"__ignoreMap":156},[174,1025,1026,1028,1030,1032,1034,1036,1039,1041,1043,1045,1047,1049],{"class":176,"line":177},[174,1027,952],{"class":279},[174,1029,373],{"class":194},[174,1031,376],{"class":204},[174,1033,379],{"class":194},[174,1035,376],{"class":204},[174,1037,1038],{"class":327},"resume",[174,1040,330],{"class":194},[174,1042,300],{"class":204},[174,1044,859],{"class":184},[174,1046,300],{"class":204},[174,1048,352],{"class":194},[174,1050,303],{"class":204},[147,1052,1054],{"className":500,"code":1053,"filename":502,"language":503,"meta":156,"style":156},"client.subscriptions.resume(\"sub_j3k4l5\")\n",[154,1055,1056],{"__ignoreMap":156},[174,1057,1058],{"class":176,"line":177},[174,1059,1053],{},[142,1061,1063],{"id":1062},"change-plan","Change Plan",[162,1065,1066,1132,1206],{"sync":164},[147,1067,1069],{"className":167,"code":1068,"filename":169,"language":170,"meta":156,"style":156},"curl -X POST http:\u002F\u002Flocalhost:4000\u002Fapi\u002Fsubscriptions\u002Fsub_j3k4l5\u002Fchange-plan \\\n  -H \"Authorization: Bearer sk_live_a1b2c3d4...\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"newPlanId\": \"plan_premium\",\n    \"prorate\": true\n  }'\n",[154,1070,1071,1084,1096,1108,1116,1121,1126],{"__ignoreMap":156},[174,1072,1073,1075,1077,1079,1082],{"class":176,"line":177},[174,1074,181],{"class":180},[174,1076,185],{"class":184},[174,1078,188],{"class":184},[174,1080,1081],{"class":184}," http:\u002F\u002Flocalhost:4000\u002Fapi\u002Fsubscriptions\u002Fsub_j3k4l5\u002Fchange-plan",[174,1083,195],{"class":194},[174,1085,1086,1088,1090,1092,1094],{"class":176,"line":198},[174,1087,201],{"class":184},[174,1089,205],{"class":204},[174,1091,208],{"class":184},[174,1093,211],{"class":204},[174,1095,195],{"class":194},[174,1097,1098,1100,1102,1104,1106],{"class":176,"line":216},[174,1099,201],{"class":184},[174,1101,205],{"class":204},[174,1103,223],{"class":184},[174,1105,211],{"class":204},[174,1107,195],{"class":194},[174,1109,1110,1112,1114],{"class":176,"line":230},[174,1111,233],{"class":184},[174,1113,236],{"class":204},[174,1115,239],{"class":184},[174,1117,1118],{"class":176,"line":242},[174,1119,1120],{"class":184},"    \"newPlanId\": \"plan_premium\",\n",[174,1122,1123],{"class":176,"line":248},[174,1124,1125],{"class":184},"    \"prorate\": true\n",[174,1127,1128,1130],{"class":176,"line":254},[174,1129,263],{"class":184},[174,1131,266],{"class":204},[147,1133,1135],{"className":269,"code":1134,"filename":271,"language":272,"meta":156,"style":156},"const updated = await client.subscriptions.changePlan('sub_j3k4l5', {\n  newPlanId: 'plan_premium',\n  prorate: true\n});\n",[154,1136,1137,1171,1187,1198],{"__ignoreMap":156},[174,1138,1139,1141,1144,1146,1148,1150,1152,1154,1156,1159,1161,1163,1165,1167,1169],{"class":176,"line":177},[174,1140,315],{"class":314},[174,1142,1143],{"class":194}," updated ",[174,1145,321],{"class":204},[174,1147,370],{"class":279},[174,1149,373],{"class":194},[174,1151,376],{"class":204},[174,1153,379],{"class":194},[174,1155,376],{"class":204},[174,1157,1158],{"class":327},"changePlan",[174,1160,330],{"class":194},[174,1162,300],{"class":204},[174,1164,859],{"class":184},[174,1166,300],{"class":204},[174,1168,864],{"class":204},[174,1170,867],{"class":204},[174,1172,1173,1176,1178,1180,1183,1185],{"class":176,"line":198},[174,1174,1175],{"class":336},"  newPlanId",[174,1177,340],{"class":204},[174,1179,236],{"class":204},[174,1181,1182],{"class":184},"plan_premium",[174,1184,300],{"class":204},[174,1186,405],{"class":204},[174,1188,1189,1192,1194],{"class":176,"line":216},[174,1190,1191],{"class":336},"  prorate",[174,1193,340],{"class":204},[174,1195,1197],{"class":1196},"sfNiH"," true\n",[174,1199,1200,1202,1204],{"class":176,"line":230},[174,1201,441],{"class":204},[174,1203,352],{"class":194},[174,1205,303],{"class":204},[147,1207,1209],{"className":500,"code":1208,"filename":502,"language":503,"meta":156,"style":156},"updated = client.subscriptions.change_plan(\n    \"sub_j3k4l5\",\n    new_plan_id=\"plan_premium\",\n    prorate=True\n)\n",[154,1210,1211,1216,1221,1226,1231],{"__ignoreMap":156},[174,1212,1213],{"class":176,"line":177},[174,1214,1215],{},"updated = client.subscriptions.change_plan(\n",[174,1217,1218],{"class":176,"line":198},[174,1219,1220],{},"    \"sub_j3k4l5\",\n",[174,1222,1223],{"class":176,"line":216},[174,1224,1225],{},"    new_plan_id=\"plan_premium\",\n",[174,1227,1228],{"class":176,"line":230},[174,1229,1230],{},"    prorate=True\n",[174,1232,1233],{"class":176,"line":242},[174,1234,548],{},[142,1236,1238],{"id":1237},"subscription-statuses","Subscription Statuses",[1240,1241,1242,1255],"table",{},[1243,1244,1245],"thead",{},[1246,1247,1248,1252],"tr",{},[1249,1250,1251],"th",{},"Status",[1249,1253,1254],{},"Description",[1256,1257,1258,1269,1278,1288,1298],"tbody",{},[1246,1259,1260,1266],{},[1261,1262,1263],"td",{},[154,1264,1265],{},"TRIALING",[1261,1267,1268],{},"Customer is in a free trial period",[1246,1270,1271,1275],{},[1261,1272,1273],{},[154,1274,650],{},[1261,1276,1277],{},"Subscription is active and billing normally",[1246,1279,1280,1285],{},[1261,1281,1282],{},[154,1283,1284],{},"PAST_DUE",[1261,1286,1287],{},"Payment failed, retrying automatically",[1246,1289,1290,1295],{},[1261,1291,1292],{},[154,1293,1294],{},"PAUSED",[1261,1296,1297],{},"Subscription is temporarily paused",[1246,1299,1300,1305],{},[1261,1301,1302],{},[154,1303,1304],{},"CANCELED",[1261,1306,1307],{},"Subscription has been canceled",[1309,1310,1311],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}",{"title":156,"searchDepth":198,"depth":198,"links":1313},[1314,1315,1316,1317,1318,1322,1323],{"id":144,"depth":198,"text":145},{"id":159,"depth":198,"text":160},{"id":565,"depth":198,"text":566},{"id":761,"depth":198,"text":762},{"id":906,"depth":198,"text":907,"children":1319},[1320,1321],{"id":911,"depth":216,"text":912},{"id":987,"depth":216,"text":988},{"id":1062,"depth":198,"text":1063},{"id":1237,"depth":198,"text":1238},"Manage the full subscription lifecycle including creation, pausing, cancellation, and plan changes.","md",null,{},{"title":101,"description":1324},"ftR4RMIQy4_48bVinLGR9zfEEho5cv6IKfDyYKzK8CA",[1331,1333],{"title":97,"path":98,"stem":99,"description":1332,"children":-1},"Create and manage subscription plans with multi-currency pricing and billing intervals.",{"title":105,"path":106,"stem":107,"description":1334,"children":-1},"Manage invoices and process payments through multiple providers.",1793401242783]