Once the payment step has been performed, regardless of its outcome, you will have to redirect the user appropriately.

Validity of the parameters that were sent in initial payment request will determine the redirection process. Basically, it depends on whether the transaction is successful, canceled or failed.

## Redirection when payment is successful

##

If status of the payment flow is **SUCCESS**, end user will be redirected to **returnurl**, which should lead directly to content.

• **One Time payment redirection**

• **Subscription redirection**

When **returnurl** is sent with a valid value (i.e. valid URL, http://www.google.com), user will be returned to the specified URL. If this parameter is not sent in the initial request, Centili will display the final payment page and remain on it by default.

In case when user is redirected to the return URL, our system will forward additional parameters in order to supply you with all necessary data about the particular transaction and its status. Those parameters will be added to return URL and are described below:

### Parameters:

If you are trying to subscribe the end user to the subscription service to which he is already subscribed, you will get additional parameters **activesub** and **validsub** ( with possible values _true_ or _false_). If user is already subscribed you should provide him with content immediately.

The same thing should occur if user has a valid but not active subscription, e.g. user has _unsubscribed_ from the service, but he still has access to the content he payed for, for the remaining period of subscription. In case when subscription is neither valid nor active user will be redirected to the payment page.

Also, in some cases when WAP flow is enabled you can get a unique identifier of the identification transaction, _identid_, concatenated to parameter list.

If user is already subscribed to the service but you are trying to subscribe him again, he will be returned back to:

You can see that user has an active subscription under our system and that he should be redirected to the content.

## Redirection when payment is canceled

##

If transaction is **CANCELED** before user entered the mobile phone number into the Centili widget he will be returned back to the initially sent **returnurl** during payment request with parameter: status=canceled.

If transaction is CANCELED by user during the payment flow we will return user back to 'returnURL' with following parameters:

• status=canceled,

• trid=231xxxxx,

• userid= <userid>,

• msisdn=<enduser_msisdn>,

• operator=<enduser_mno>,

• reference=<your_transaction_identifier >.

## Redirection when payment is failed

##

If transaction is in **FAILED** state it means that some error occurred during the payment flow and user will also be returned back with following parameters:

• status=failed,

• trid=231xxxxxx,

• userid=<userid>,

• reference=<passthrough variable from your system>,

• error_description=<description of the error which caused transaction to fail>

Depending on the country your services are deployed to, parameters you receive in this redirection may vary. For the final update please check with Centili Platform Operations team via [[email protected]](🔗)

📘

Subscription redirect process

When initiating the payment request for subscription services our Payment Page will automatically check if there is any active subscription under our system for the current user. If user is not subscribed, it will proceed with subscription process and following payment.

## Next step...

### **[Payment Result Notification](🔗)**

The final step of every payment transaction is being notified of the outcome - i.e. whether the payment was successful or not. Payment result notification provides you with all the relevant data for your further processing.

Please refer to [Payment Result Notification](🔗) guide for complete reference on how to get notifications.