Unfortunately the Stripe API doesn't allow for scheduling pauses. Instead, we now have an option on this page where you can set "Pause wall to show at the end of the billing cycle" on Churnkey | Flows | Settings. This setting switched to end of term will do a few things:
It will set the pause end date to be at the end of the billing term of the nth month after pause. For example, if someone pauses on May 15th and their billing period renews on the 30th, a 2-month pause will pause until July 30th instead of July 15th. Note that the pause will still be applied immediately, but the end date will be moved further until the end of that future billing cycle.
Within the Stripe subscription metadata, there will be a
pauseWallStartDateset tosubscription.current_period_endwhen the customer pauses. We use this internally for the pause wall, but if you want to use it for your own purposes it will be thereThe pause wall will only render after the current date is greater than
pauseWallStartDate(and until the subscription is resumed at the end of the pause date).