Grace period

A grace period is a period of deferred payment. During this period, users who have not paid for their subscription on time can continue using the services. A grace period is only available for regular plan and one-time payment subscriptions.

How it works

Xsolla notifies users that they need to make a payment when the grace period is activated and each subsequent day of the grace period.


  • If the user pays for a subscription during the grace period, payment is made for the full payment period.
  • The number of days the user has access to the partner’s service without actual payment is subtracted from the total number of days in a subscription period.

How to get it

You can set up grace period in one of the following ways:

Via Publisher Account

  1. Open your project in Publisher Account.
  1. Click Subscriptions in the side menu.
  1. Create a new plan with the Regular plan type or select an existing one.
  1. Proceed to step 2 if you are creating a new plan, or open the Payment Information tab if you are editing a plan.
  1. Go to the For one-time payment section, and in the Grace period field, specify the length of the grace period. If the plan should not have a grace period, set the value to 0.
  1. Complete the new subscription plan or save changes to the existing one.

Via API calls

To set a grace period using API calls, pass the following parameters to the Create Plan or Update Plan API call:

  • grace_period.value with the number of grace period days
  • grace_period.type with the day value

Was this article helpful?
Thank you!
Is there anything we can improve? Message
We’re sorry to hear that
Please explain why this article wasn’t helpful to you. Message
Thank you for your feedback!
We’ll review your message and use it to help us improve your experience.
Rate this page
Rate this page
Is there anything we can improve?

Don’t want to answer

Thank you for your feedback!
Last updated: January 23, 2024

Found a typo or other text error? Select the text and press Ctrl+Enter.

Report a problem
We always review our content. Your feedback helps us improve it.
Provide an email so we can follow up
Thank you for your feedback!