To redirect users to another page after they completed the payment, you can configure two types of redirects:

• automatic — a redirect with a set delay.
• manual — a redirect after a user closes the payment UI or clicks the redirect button.

You can configure a redirect in the following ways:

• in Publisher Account — use this option if you are setting up a project for a single application and don’t plan to create builds for different platforms.

• in the SDK settings — use this option if you plan to:
  • use the project for multiple applications
  • create builds for different platforms
  • sell in-game items via the website

Configure redirects in Publisher Account

1. Open your project in Publisher Account.
2. Click Pay Station in the side menu.
3. Go to the Settings > Redirect policy section.

4. In the Return URL field, enter the URL or path where a user is redirected to after making a payment.

5. To set automatic redirect parameters:
   1. In the drop-down list, choose Automatic redirect condition:
      • None — do not redirect.
      • Successful payment — redirect when a payment is successful.
      • Successful or canceled payment — redirect when a payment is successful or canceled.
      • Any payment — redirect for any payment status.
   2. In the Delay field, enter a redirect timeout in seconds. By default, a redirect is activated in 0 seconds.

6. To set manual redirect parameters:
   1. In the drop-down list, choose Manual redirect condition:
      • None — do not redirect.
      • Successful payment — the redirect button appears when a payment is successful.
      • Successful or canceled payment — the redirect button appears when a payment is successful or canceled.
      • Any payment — the redirect button appears for any payment status.
   2. In the Redirect button caption field, enter the copy for the button that redirects a user to the return URL.

7. Click Save.

Configure redirects in SDK settings

Pass the redirect parameters to the init method. To do this, add the lines in the source code of your project in Cocos Creator in accordance with the example for Android build below. Set redirect parameters:

1. In the useSettingsFromPublisherAccount pass false.
2. In the returnUrl parameter, pass a URL or a path a user will be redirected to after making a payment.

3. To set automatic redirect parameters:
   1. In the redirectCondition parameter, pass conditions when a redirect is activated:
      • PaymentRedirectCondition.none — do not redirect.
      • PaymentRedirectCondition.successful — redirect when a payment is successful.
      • PaymentRedirectCondition.successful_or_canceled — redirect when a payment is successful or canceled.
      • PaymentRedirectCondition.any — redirect for any payment status.
   2. In the redirectDelay parameter, pass a redirect timeout in seconds.

4. To set manual redirect parameters:
   1. In the redirectStatusManual parameter, pass a payment status when the redirect button appears:
      • PaymentRedirectCondition.none — do not redirect.
      • PaymentRedirectCondition.successful — redirect when a payment is successful.
      • PaymentRedirectCondition.successful_or_canceled — redirect when a payment is successful or canceled.
      • PaymentRedirectCondition.any — redirect for any payment status.
   2. In the redirectButtonCaption parameter, pass copy for the button that redirects a user to the return URL.

Example of setting up redirects for Android build:

let redirectPolicySettingsAndroid: RedirectPolicySettings = {
                useSettingsFromPublisherAccount: false,
                returnUrl: 'app://xpayment.com.example.myapp',
                redirectCondition: PaymentRedirectCondition.successful,
                redirectDelay: 0,
                redirectStatusManual: PaymentRedirectStatusManual.successful,
                redirectButtonCaption: 'Back to the game'
        };
var settings: XsollaSettings = {
            loginId: '<yourLoginId>',
            projectId: '<yourProjectId>',
            clientId: '<yourClientId>',
            enableSandbox: IsSandbox,
            redirectPolicySettingsAndroid: redirectPolicySettingsAndroid
        }

        Xsolla.init(settings);