Upgrade Subscription is used to upgrade a user's current subscription to a higher package or downgrade it to a lower package through Kuika's Iyzico integration. This action allows users to flexibly change their subscription plans, while application developers can automate these transitions.
Technical Features
Plan Upgrade and Downgrade Support: Enables users to switch to a more comprehensive or more limited package from their current subscription plan.
Real-Time Updates: Subscription changes are instantly communicated to the Iyzico system and results are received.
Web and Mobile App Support: The action works on both web and mobile applications.
Upgrade Subscription Action Application Steps
Log in to the Kuika platform.
Select your project from the Apps screen.
Go to the UI Design module.
Open the Properties panel on the right side.
From the + ADD ACTION menu, add the Payment Iyzico> Upgrade Subscription action according to the trigger event you want (Initial Actions, OnClick, OnBlur, etc.).
Configure the following parameters in the settings panel that opens:
User Name: The username of the user whose subscription will be updated.
New Pricing Plan Reference Code: The reference code of the new subscription plan to be switched to on Iyzico. (Each plan has its own unique reference code.)
Click the SAVE button to complete the process.
Usage Scenario: Plan Upgrade on the Training Platform
A user has a “Starter” subscription that provides access to basic level courses. When they want to access more content, they click the “Upgrade Plan” button to switch to the ‘Professional’ plan.
Scenario Flow:
The user clicks the “Upgrade Plan” button.
The Upgrade Subscription action is assigned to the OnClick event associated with this button.
The user's name (User Name) and the new plan's reference code (New Pricing Plan Reference Code) are retrieved from the system.
The action runs and Iyzico upgrades the user to the new plan.
A successful upgrade notification is displayed to the user.
Content associated with the new plan (e.g., advanced courses) becomes visible to the user.
Dynamic Plan Selection: Reference codes can be used in different actions depending on the plan selected by the user.
Plan Comparison Module: Users can be shown a comparison of the current plan and the new plan features.
Post-Transition Notification: An informational email or notification can be sent to the user after the plan change.
Role Update: The user's system role can be automatically changed according to the new plan.
Technical Risks
Invalid Reference Code: If the New Pricing Plan Reference Code value is incorrect, the transition will fail. The code must be checked for accuracy.
Active Subscription Status: If the user does not have a valid subscription, this action will not work. It is recommended to check with Retrieve Subscription beforehand.
Repeated Plan Transitions: To prevent users from transitioning to the same plan again, the current plan should be displayed to the user.
Retroactive Payment or Refund: In some plan transitions, fee differences or refunds may occur in the Iyzico system. Support documentation should be reviewed for these scenarios.
Upgrade Subscription is one of the core tools for providing subscription flexibility in user-focused applications. In Kuika, it works seamlessly with Iyzico to make plan upgrades and downgrades fast, secure, and user-friendly.
