Regarding failed subscription payments

Dear administrator,

Thank you for your help!

Currently, we are using the Square API to build a subscription payment function in a sandbox environment, but we are contacting you to confirm the behavior when a payment fails.

Could you please tell us the following points?

If a subscription payment fails, will Square automatically retry?

If an automatic retry is performed, will the number of purchases for the plan be updated without being reset?

Is there a specification that notifies customers when a payment fails?

If the above settings can be customized, what are the specific steps to set them up?

I apologize for bothering you at the time, but I would appreciate your response.

Thank you in advance.

:wave: 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

Additional Documentation

Square Developer
Square Sandbox
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.

When a subscription payment fails, Square does not automatically retry the payment. It’s the responsibility of the partner application to handle failed payments.

If a payment fails, the number of purchases for the plan will not be updated automatically. You would need to manually adjust this in your application.

Square does send an invoice to the customer if a payment is missed or fails so the customer can pay through the invoice to stay current. It’s the responsibility of the partner application to handle communication with customers in the event of a failed payment.

As for customizing these settings, there isn’t a built-in way to do this through Square’s APIs. You would need to build these functionalities into your own application. For example, you could use the webhooks provided by the Invoices API to track failed invoice payments and then implement your own logic to retry payments, update the number of purchases, and notify customers as needed. :slight_smile:

1 Like

Thank you for your reply.

I understand the above.

I may have more questions, so thank you in advance.