# \#subscriptions-api **URL:** https://developer.squareup.com/forums/tag/subscriptions-api/20.md [Latest](https://developer.squareup.com/forums/latest.md) · [Categories](https://developer.squareup.com/forums/categories.md) · [Tags](https://developer.squareup.com/forums/tags.md) --- ## [Square Subscriptions API — Updating Recurring Prices Mid-Cycle Without Changing Billing Dates](https://developer.squareup.com/forums/t/square-subscriptions-api-updating-recurring-prices-mid-cycle-without-changing-billing-dates/28215)
**Author:** [@hello123](https://developer.squareup.com/forums/u/hello123)\ **Replies:** 1\ **Last updated:** [October 15, 2026, 4:20pm UTC](https://developer.squareup.com/forums/t/square-subscriptions-api-updating-recurring-prices-mid-cycle-without-changing-billing-dates/28215 "2026-10-15T16:20:10Z")
Hello, I’m developing a subscription-based platform that uses Square for recurring billing, saved payment methods, and one-time payments. Our customers can choose monthly, quarterly, semiannual, or annual subscriptions… --- ## [Production subscription locked after removing a scheduled plan change — HTTP 500 on subsequent SwapPlan](https://developer.squareup.com/forums/t/production-subscription-locked-after-removing-a-scheduled-plan-change-http-500-on-subsequent-swapplan/28082)
**Author:** [@enigma65](https://developer.squareup.com/forums/u/enigma65)\ **Replies:** 1\ **Last updated:** [October 5, 2026, 7:04pm UTC](https://developer.squareup.com/forums/t/production-subscription-locked-after-removing-a-scheduled-plan-change-http-500-on-subsequent-swapplan/28082 "2026-10-05T19:04:27Z")
We’re testing subscription billing for a SaaS web app before launch and have encountered a locked production subscription. Here’s the sequence: Registered and paid for our Basic plan at $19/month. Upgraded immediately… --- ## [Is this really the only way to get support from Square?](https://developer.squareup.com/forums/t/is-this-really-the-only-way-to-get-support-from-square/28099)
**Author:** [@enigma65](https://developer.squareup.com/forums/u/enigma65)\ **Replies:** 1\ **Last updated:** [October 5, 2026, 3:15pm UTC](https://developer.squareup.com/forums/t/is-this-really-the-only-way-to-get-support-from-square/28099 "2026-10-05T15:15:21Z")
Posted a question last week and still no answer. For 3.3% of all my client transactions I expected something more. --- ## [Production subscription is "locked and is not billable" after DeleteSubscriptionAction on a SWAP\_PLAN action — request to unlock](https://developer.squareup.com/forums/t/production-subscription-is-locked-and-is-not-billable-after-deletesubscriptionaction-on-a-swap-plan-action-request-to-unlock/28009)
**Author:** [@LunaDesign](https://developer.squareup.com/forums/u/LunaDesign)\ **Replies:** 2\ **Last updated:** [September 29, 2026, 10:57pm UTC](https://developer.squareup.com/forums/t/production-subscription-is-locked-and-is-not-billable-after-deletesubscriptionaction-on-a-swap-plan-action-request-to-unlock/28009 "2026-09-29T22:57:11Z")
Hi Square team, One of our production subscriptions (Japan) has been stuck in a locked state since 2026-09-26 JST. I would like to ask for it to be unlocked. Subscription ID: 901ad8fe-1706-4dd5-8360-c4df7dec87da Envi… --- ## [How can I get the next billing date for a subscription?](https://developer.squareup.com/forums/t/how-can-i-get-the-next-billing-date-for-a-subscription/27990)
**Author:** [@fukuda](https://developer.squareup.com/forums/u/fukuda)\ **Replies:** 2\ **Last updated:** [September 29, 2026, 10:19am UTC](https://developer.squareup.com/forums/t/how-can-i-get-the-next-billing-date-for-a-subscription/27990 "2026-09-29T10:19:38Z")
I want to know how to get the next credit card billing date using the Square Subscription API. According to the following forum post, charged\_through\_date can be used: Could you clarify which of the following is corr… --- ## [Sandbox CreateSubscription is immediately DEACTIVATED before START\_SUBSCRIPTION](https://developer.squareup.com/forums/t/sandbox-createsubscription-is-immediately-deactivated-before-start-subscription/27964)
**Author:** [@Samvel-Miyawaki](https://developer.squareup.com/forums/u/Samvel-Miyawaki)\ **Replies:** 1\ **Last updated:** [September 25, 2026, 7:02pm UTC](https://developer.squareup.com/forums/t/sandbox-createsubscription-is-immediately-deactivated-before-start-subscription/27964 "2026-09-25T19:02:45Z")
Title Sandbox CreateSubscription is immediately DEACTIVATED before START\_SUBSCRIPTION Body Hello Square Developer Support, I am developing a subscription service using the Square API and am testing the integration in… --- ## [Subscription Payment Link checkout fails in Japan before Payment or Subscription is created](https://developer.squareup.com/forums/t/subscription-payment-link-checkout-fails-in-japan-before-payment-or-subscription-is-created/27970)
**Author:** [@jvp-rider-lab](https://developer.squareup.com/forums/u/jvp-rider-lab)\ **Replies:** 3\ **Last updated:** [September 25, 2026, 6:18pm UTC](https://developer.squareup.com/forums/t/subscription-payment-link-checkout-fails-in-japan-before-payment-or-subscription-is-created/27970 "2026-09-25T18:18:39Z")
Hello, I am implementing a monthly subscription using the Square Checkout API in Production in Japan. The Payment Link is created successfully with HTTP 200. However, when the buyer enters the required information on t… --- ## [DeleteSubscriptionAction returns HTTP 500, and an unexpected charge occurred after deleting a SWAP\_PLAN action](https://developer.squareup.com/forums/t/deletesubscriptionaction-returns-http-500-and-an-unexpected-charge-occurred-after-deleting-a-swap-plan-action/27488)
**Author:** [@szsuke](https://developer.squareup.com/forums/u/szsuke)\ **Replies:** 10\ **Last updated:** [September 18, 2026, 7:34am UTC](https://developer.squareup.com/forums/t/deletesubscriptionaction-returns-http-500-and-an-unexpected-charge-occurred-after-deleting-a-swap-plan-action/27488 "2026-09-18T07:34:23Z")
Hello, We are a Japanese nonprofit organization using the Subscriptions API in production. We are experiencing two issues that appear to be related and would appreciate your help investigating them. Target Location ID … --- ## [Checkout-created STATIC subscription retains $1 order template after plan swap and continues billing $1 — what is the supported way to implement subscription discounts?](https://developer.squareup.com/forums/t/checkout-created-static-subscription-retains-1-order-template-after-plan-swap-and-continues-billing-1-what-is-the-supported-way-to-implement-subscription-discounts/27606)
**Author:** [@diego-eh](https://developer.squareup.com/forums/u/diego-eh)\ **Replies:** 1\ **Last updated:** [September 11, 2026, 10:43pm UTC](https://developer.squareup.com/forums/t/checkout-created-static-subscription-retains-1-order-template-after-plan-swap-and-continues-billing-1-what-is-the-supported-way-to-implement-subscription-discounts/27606 "2026-09-11T22:43:22Z")
We are trying to determine the supported way to implement an introductory subscription discount using Square, and we have encountered production behavior that doesn’t seem to match the current documentation or previous f… --- ## [Can square\_card\_id from a third-party card import mapping file be used as card\_id in CreateSubscription?](https://developer.squareup.com/forums/t/can-square-card-id-from-a-third-party-card-import-mapping-file-be-used-as-card-id-in-createsubscription/26811)
**Author:** [@jiyu](https://developer.squareup.com/forums/u/jiyu)\ **Replies:** 1\ **Last updated:** [July 24, 2026, 5:35pm UTC](https://developer.squareup.com/forums/t/can-square-card-id-from-a-third-party-card-import-mapping-file-be-used-as-card-id-in-createsubscription/26811 "2026-07-24T17:35:44Z")
Hi, We are planning to migrate existing subscribers from Stripe to Square. Square Support in Japan confirmed the following: Third-party card data can be imported from Stripe to Square. After the card import, the sell… --- ## [Payment failed with multiple reasons](https://developer.squareup.com/forums/t/payment-failed-with-multiple-reasons/26042)
**Author:** [@james-hill](https://developer.squareup.com/forums/u/james-hill)\ **Replies:** 2\ **Last updated:** [May 8, 2026, 3:29pm UTC](https://developer.squareup.com/forums/t/payment-failed-with-multiple-reasons/26042 "2026-05-08T15:29:43Z")
Hello developers, can you all please help resolve the issue I am facing with my API integrations?I have successfully integrated the Square payment gateway service into my website and we also received some successful test… --- ## [Using Apple Pay/Google Pay for Subscriptions](https://developer.squareup.com/forums/t/using-apple-pay-google-pay-for-subscriptions/25700)
**Author:** [@jpc](https://developer.squareup.com/forums/u/jpc)\ **Replies:** 1\ **Last updated:** [March 30, 2026, 3:31am UTC](https://developer.squareup.com/forums/t/using-apple-pay-google-pay-for-subscriptions/25700 "2026-03-30T03:31:04Z")
I am using the Web Payments SDK to create Subscriptions. Is there a way for customers to use Apple/Google Pay to make recurring payments for Square Subscriptions? --- ## [Why Can’t Square Cancel Unpaid Subscriptions Immediately? This Is a Major Problem](https://developer.squareup.com/forums/t/why-can-t-square-cancel-unpaid-subscriptions-immediately-this-is-a-major-problem/25403)
**Author:** [@DebisU](https://developer.squareup.com/forums/u/DebisU)\ **Replies:** 1\ **Last updated:** [February 19, 2026, 6:34pm UTC](https://developer.squareup.com/forums/t/why-can-t-square-cancel-unpaid-subscriptions-immediately-this-is-a-major-problem/25403 "2026-02-19T18:34:22Z")
I’ve spent the last few days digging deeply into how Square Subscriptions behave, and I still can’t understand how such a critical product can have limitations this severe after so many years. The core issue is that the… --- ## [To confirm the subscription payment flow](https://developer.squareup.com/forums/t/to-confirm-the-subscription-payment-flow/25356)
**Author:** [@Shubham](https://developer.squareup.com/forums/u/Shubham)\ **Replies:** 3\ **Last updated:** [February 18, 2026, 8:05am UTC](https://developer.squareup.com/forums/t/to-confirm-the-subscription-payment-flow/25356 "2026-02-18T08:05:20Z")
Hi @Bryan-Square , So, pls confirm me this, what I am doing is this whenever I get an invoice.updated webhook, I look for subscription\_id in it then I fetch the API response from retrieve\_susbcription method using that s… --- ## [Subscription ID in invoices](https://developer.squareup.com/forums/t/subscription-id-in-invoices/13362)
**Author:** [@Mr.Qinu](https://developer.squareup.com/forums/u/Mr.Qinu)\ **Replies:** 12\ **Last updated:** [February 12, 2026, 5:25am UTC](https://developer.squareup.com/forums/t/subscription-id-in-invoices/13362 "2026-02-12T05:25:30Z")
Hi there, As far as I can tell, Subscriptions API appears to be built on top of Invoices API, so I am tagging both in hopes it is specific enough. Our subscription service requires the subscription to be paused immedia… --- ## [\[sandbox\] inconsistent support of emails like test@example.com](https://developer.squareup.com/forums/t/sandbox-inconsistent-support-of-emails-like-test-example-com/25316)
**Author:** [@nymkappamempoolspace](https://developer.squareup.com/forums/u/nymkappamempoolspace)\ **Replies:** 1\ **Last updated:** [February 9, 2026, 7:52pm UTC](https://developer.squareup.com/forums/t/sandbox-inconsistent-support-of-emails-like-test-example-com/25316 "2026-02-09T19:52:25Z")
Hi, My OP was asking about possibly a broken sandbox credit card support on your end but I remembered that I had the same issue a while ago (see https://developer.squareup.com/forums/t/sandbox-card-4111-1111-1111-1111-d… --- ## [How to create a subscription model for an app reac and webservice](https://developer.squareup.com/forums/t/how-to-create-a-subscription-model-for-an-app-reac-and-webservice/25242)
**Author:** [@ffrancoc1972](https://developer.squareup.com/forums/u/ffrancoc1972)\ **Replies:** 4\ **Last updated:** [February 2, 2026, 7:39pm UTC](https://developer.squareup.com/forums/t/how-to-create-a-subscription-model-for-an-app-reac-and-webservice/25242 "2026-02-02T19:39:26Z")
Hi! I trully apologize if this is too easy for everyone. I’ve build my app react and webservice by myself with not any IT background (just AI). I have it 95% finished, but I’m not able to make SQUARE of my platform “talk… --- ## [Coupon field not showing on payment form](https://developer.squareup.com/forums/t/coupon-field-not-showing-on-payment-form/24867)
**Author:** [@blackfog](https://developer.squareup.com/forums/u/blackfog)\ **Replies:** 2\ **Last updated:** [January 2, 2026, 11:10am UTC](https://developer.squareup.com/forums/t/coupon-field-not-showing-on-payment-form/24867 "2026-01-02T11:10:13Z")
Currently creating payment links for subscriptions (QuickPay) and everything is working smoothly. However, I’m not seeing the coupon code field showing up on the form. We are explicitly setting enable\_coupon to true, bu… --- ## [SUBSCRIPTION ERRORS - :An internal error has occurred,: HELP?!](https://developer.squareup.com/forums/t/subscription-errors-an-internal-error-has-occurred-help/24745)
**Author:** [@NemoNoman](https://developer.squareup.com/forums/u/NemoNoman)\ **Replies:** 6\ **Last updated:** [December 9, 2025, 12:28am UTC](https://developer.squareup.com/forums/t/subscription-errors-an-internal-error-has-occurred-help/24745 "2025-12-09T00:28:37Z")
HELP??!!?? I have been struggling to fix the email and web responses show to users who make new subscriptions, and having trouble identififying the erros in may API code that are causing these response to get reallly me… --- ## [Implement Multi-Phase Subscription (Setup + Recurring) with Payment Links?](https://developer.squareup.com/forums/t/implement-multi-phase-subscription-setup-recurring-with-payment-links/24581)
**Author:** [@maksudul](https://developer.squareup.com/forums/u/maksudul)\ **Replies:** 6\ **Last updated:** [November 24, 2025, 5:23pm UTC](https://developer.squareup.com/forums/t/implement-multi-phase-subscription-setup-recurring-with-payment-links/24581 "2025-11-24T17:23:55Z")
Hi everyone, I have been reading through this discussion regarding the confusion between Subscription Variations vs Subscription Phases and how to properly link them to a Checkout Payment Link. I understand the concept… --- ## [Question About Changes to SMS Subscription When Registering for Loyalty](https://developer.squareup.com/forums/t/question-about-changes-to-sms-subscription-when-registering-for-loyalty/24192)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 10\ **Last updated:** [October 16, 2025, 8:27pm UTC](https://developer.squareup.com/forums/t/question-about-changes-to-sms-subscription-when-registering-for-loyalty/24192 "2025-10-16T20:27:48Z")
Hi Square Team, I hope you’re doing well! I have a question regarding the SMS subscription behavior when registering for Square Loyalty. Has Square made any changes in October 2025 to the automatic SMS subscription … --- ## [Handling Gift Subscriptions](https://developer.squareup.com/forums/t/handling-gift-subscriptions/24225)
**Author:** [@NemoNoman](https://developer.squareup.com/forums/u/NemoNoman)\ **Replies:** 3\ **Last updated:** [October 14, 2025, 8:48pm UTC](https://developer.squareup.com/forums/t/handling-gift-subscriptions/24225 "2025-10-14T20:48:54Z")
We use Square Subscriptions in my home-built yoga-studio membership system. Thinking about home-building a Gift Suscription method, and I need some clarification on supported workflows. Deferred-activation gift subsc… --- ## [What are the differences between subscriptions and recurring invoices?](https://developer.squareup.com/forums/t/what-are-the-differences-between-subscriptions-and-recurring-invoices/10210)
**Author:** [@axme](https://developer.squareup.com/forums/u/axme)\ **Replies:** 7\ **Last updated:** [October 14, 2025, 4:15pm UTC](https://developer.squareup.com/forums/t/what-are-the-differences-between-subscriptions-and-recurring-invoices/10210 "2025-10-14T16:15:02Z")
Hi, I have a customer who instead of using the subscriptions feature is using the recurring invoices feature on their POS\> If it’s a recurring invoice, is the cancel invoice the equivalent endpoint to listen to for a s… --- ## [Swapping Subscription Plans](https://developer.squareup.com/forums/t/swapping-subscription-plans/24154)
**Author:** [@jsoa](https://developer.squareup.com/forums/u/jsoa)\ **Replies:** 1\ **Last updated:** [October 13, 2025, 12:46pm UTC](https://developer.squareup.com/forums/t/swapping-subscription-plans/24154 "2025-10-13T12:46:28Z")
Regarding this comment from a different thread, I don’t see an option to switch plans with subscription\_plan\_id field. Doesn’t seem to exist on the UpdateSubscription endpoint. From the same thread it’s also mentioned t… --- ## [How to Check and Manage Text Message Marketing Subscriptions via API](https://developer.squareup.com/forums/t/how-to-check-and-manage-text-message-marketing-subscriptions-via-api/24065)
**Author:** [@murphyzhang](https://developer.squareup.com/forums/u/murphyzhang)\ **Replies:** 6\ **Last updated:** [September 29, 2025, 4:18pm UTC](https://developer.squareup.com/forums/t/how-to-check-and-manage-text-message-marketing-subscriptions-via-api/24065 "2025-09-29T16:18:31Z")
Hi Square Team, I hope you’re doing well! I have a question regarding the Customer API. I understand that I can use the Square Customer API to check whether a customer is subscribed to email marketing. Is there als… --- ## [Sandbox Subscriptions](https://developer.squareup.com/forums/t/sandbox-subscriptions/23778)
**Author:** [@C-Lo](https://developer.squareup.com/forums/u/C-Lo)\ **Replies:** 3\ **Last updated:** [September 3, 2025, 11:56am UTC](https://developer.squareup.com/forums/t/sandbox-subscriptions/23778 "2025-09-03T11:56:37Z")
Hi so developing a website that uses Square for subscriptions. Very confused with testing so far. My application created a subscription payment link - Checkout API Sandbox Testing Panel I have gone through the steps o… --- ## [Select a specific phase when swapping a subscription plan?](https://developer.squareup.com/forums/t/select-a-specific-phase-when-swapping-a-subscription-plan/23737)
**Author:** [@IPACCam](https://developer.squareup.com/forums/u/IPACCam)\ **Replies:** 7\ **Last updated:** [August 22, 2025, 5:50pm UTC](https://developer.squareup.com/forums/t/select-a-specific-phase-when-swapping-a-subscription-plan/23737 "2025-08-22T17:50:46Z")
Hello, I have one SubscriptionPlan, with three SubscriptionPlanVariation’s. Each of the variations has two phases: (1) a two-week free trial, and (2) a billed monthly cycle. I’d like to give users the ability to swap… --- ## [Auto debit for subscriptions is not working](https://developer.squareup.com/forums/t/auto-debit-for-subscriptions-is-not-working/23613)
**Author:** [@synapkaushik](https://developer.squareup.com/forums/u/synapkaushik)\ **Replies:** 2\ **Last updated:** [August 11, 2025, 4:21pm UTC](https://developer.squareup.com/forums/t/auto-debit-for-subscriptions-is-not-working/23613 "2025-08-11T16:21:47Z")
Please i need guidance in the auto debit feature. --- ## [Subscription is locked](https://developer.squareup.com/forums/t/subscription-is-locked/14776)
**Author:** [@vigneshp2](https://developer.squareup.com/forums/u/vigneshp2)\ **Replies:** 9\ **Last updated:** [July 10, 2025, 5:04pm UTC](https://developer.squareup.com/forums/t/subscription-is-locked/14776 "2025-07-10T17:04:54Z")
I was in the process of changing the billing anchor date of a subscription. I have a subscription whose billing date is 23rd and the customer wanted to advance it to 15th. So when I set the billing anchor date as below: … --- ## [/v2/subscriptions/bulk-swap-plan Internal Server Error](https://developer.squareup.com/forums/t/v2-subscriptions-bulk-swap-plan-internal-server-error/22879)
**Author:** [@aidansw](https://developer.squareup.com/forums/u/aidansw)\ **Replies:** 8\ **Last updated:** [July 9, 2025, 5:22pm UTC](https://developer.squareup.com/forums/t/v2-subscriptions-bulk-swap-plan-internal-server-error/22879 "2025-07-09T17:22:51Z")
Square-Version: 2025-06-18’ '{ "new\_plan\_variation\_id": "6C3QMZ6RQNJZMUC3HQNYF5SS", "old\_plan\_variation\_id": "GJNUSIDUPTX4U6H4FFXFAJN6", "location\_id": "LYD2D6750FT2G" }' Results in: { "errors": \[ … [Next page](https://developer.squareup.com/forums/tag/subscriptions-api/20.md?match_all_tags=true&page=1&tags%5B%5D=subscriptions-api)