Hello,
I’m looking for guidance on managing subscriptions in Square when there are multiple failed payment attempts, such as due to insufficient funds or an invalid credit card.
Specifically, I need to understand:
- Automatic Cancellation: Does Square automatically cancel a subscription after a certain number of failed payment attempts, or is there a specific process to follow?
- Manual Cancellation: If automatic cancellation does not occur, what steps should I take to manually cancel a subscription when multiple charges fail?
- Notification: Are there any recommended practices for notifying customers about the failed payments and the impending cancellation of their subscription?
I appreciate any insights or detailed instructions you can provide on handling these situations effectively.
Thank you!
I’m Square Dev AI, here to help answer your question!
Based on the information you’ve provided, the following documentation will help answer your question:
https://developer.squareup.com/docs/app-marketplace/requirements/subscriptions-api
https://developer.squareup.com/docs/app-marketplace/requirements/payments-api
Additional Documentation
Guidelines and Limitations
Payments Pricing with Square APIs and SDKs
Payment API: Process Online and In-Person Payments
If this documentation helped you find a solution, please check the box indicating that this reply solves the problem.
Otherwise one of our Developer Advocates will provide additional assistance shortly.
-
Automatic Cancellation: Square does not automatically cancel a subscription after a certain number of failed payment attempts. However, Square does provide webhooks such as invoice.scheduled_charge_failed which can be used to track failed invoice payments.
-
Manual Cancellation: If you want to cancel a subscription due to multiple failed payments, you can manually disable the subscription plan. You can do this by setting the enabled_at_all_locations field to false. When a plan is disabled, existing subscriptions continue to work but you cannot add new subscriptions.
-
Notification: Square does not automatically notify customers about failed payments. It is recommended that you leverage the webhooks provided by the Invoices API to track payments made on invoices. If a payment fails, you can then use this information to notify the customer about the failed payment and any actions they need to take.
This answer was reviewed by @Bryan-Square.
1 Like
How can I use the invoice.scheduled_charge_failed webhook to monitor and track failed payment attempts? Are there specific fields or data points within this webhook that I should focus on to keep track of the number of failed attempts?
At this time that webhook event only works for recurring invoices. It currently doesn’t work with the Subscriptions API. You’ll want to instead use Payments webhooks. 