Retrieve Subscription is a system action that allows you to access a user's active or past subscription information in your application through Kuika's Iyzico integration. This action is used to query subscription details and manage them with additional actions.
Technical Features
Real-Time Querying: The user's subscription information registered in the Iyzico system is retrieved instantly.
Web and Mobile Application Support: The action works seamlessly on both web and mobile applications.
Extensible Usage: The retrieved information can be displayed in the user interface or used with conditional logic.
Retrieve Subscription Action Application Steps
Log in to the Kuika platform.
Open the project you will be working on 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> Retrieve Subscription action according to the desired trigger event (Initial Actions, OnClick, OnBlur, etc.).
Configure the following field in the settings that opens:
User Name: The username of the user whose subscription information will be queried.
Click the SAVE button to complete the configuration.
Usage Scenario: Viewing Subscription Information on the User Profile Page
When a user enters the “My Subscription Information” screen, the system triggers the Retrieve Subscription action in the background.
Scenario Flow:
The user logs into the profile page in the application.
The action is executed with the OnLoad trigger when the page opens.
The user's subscription plan, start date, validity period, payment status, and other information are retrieved from Iyzico.
This information is displayed in the card components or information boxes on the screen.
If the subscription is not active, alternative actions such as “Start Subscription” are displayed.
Dynamic User Query: The User Name parameter can be automatically assigned based on the logged-in user's information.
Using the Result Data: The incoming data can be used as a trigger for other actions (e.g., displaying a warning if the subscription period has expired, disabling buttons).
Conditional Flows: If subscription information cannot be retrieved, the message “Your subscription could not be found” can be displayed to the user.
Technical Risks
Invalid User Name: If User Name is incorrect or left blank, data cannot be retrieved from Iyzico and an error is returned.
Timing Errors: If user information is called before the screen loads, data synchronization issues may occur. An appropriate trigger such as OnReady should be used instead of OnLoad.
Empty Result Data: If the user has no subscriptions, the result may be empty. In this case, informational messages should be added to prevent the screen from remaining blank.
Retrieve Subscription allows you to query the user's subscription information in real-time within your Kuika application. It plays a critical role in various scenarios such as profile pages, payment history, and automatic renewal checks. By using this action with the correct trigger and data, you can effectively integrate subscription management into your system.
