Charge Payment Method is an action used within Kuika's Stripe integration. This action allows users to make payments easily, quickly, and securely using their previously saved payment methods (credit card, etc.).
It is typically used after the payment method has been saved with the Setup Intent action and is preferred for recurring payments or to speed up the user experience.
Technical Features
Pay with Saved Card: Enables transactions to be made using the payment method previously saved with Setup Intent.
Web and Mobile App Support: Can be used in web and mobile applications.
Advanced Payment Scenarios: Supports payment routing to a single account or multiple Stripe accounts (suitable for application-based usage scenarios).
Stripe PCI Compliance: Payment transactions are processed through Stripe's secure infrastructure, and sensitive card information is not stored in the application.
Charge Payment Method Action Application Steps
Log in to the Kuika platform.
Open the project you want to work on from the Apps screen.
Go to the UI Design module.
Select the UI element that will trigger the payment process (e.g., “Start Subscription” button).
Click +ADD ACTION in the Properties panel on the right side.
Select the button and add the Payment Stripe > Charge Payment Method action from the + ADD ACTION menu according to the desired trigger event (Initial Actions, OnClick, OnBlur, etc.).
Parameters
Payment Method: The parameter entry method can be selected using “Symbol Picker (B)” in the added action.
In order to receive payment, the “Setup Intent” action must be created and called beforehand.
Then, in the “Charge Payment Method → Payment Method” section, use “Symbol Picker” to select “Action Results → Setup Intent → Payment Method” to complete the connection.
Currency: The currency in which the transaction will take place (e.g., USD, EUR, TRY). It must be defined in your Stripe account.
Amount: The amount to be paid must be entered in the smallest unit of the selected currency. For example: A value of 1000 represents 10 dollars for USD and 10 TL for TRY based on the exchange rate.
Description: Payment description. For example, “Monthly Premium Subscription”.
Customer Mail Address: The email address of the customer associated with the transaction. This facilitates tracking in the Stripe panel.
Payment Distribution Options
Single/Multi Part: Determines the distribution method of the payment received.
If the payment will be transferred to a single account: Select “Single”.
If the payment will be divided into multiple accounts: Select ‘Multi’.
When “Multi” is selected, the following parameters are added:
Application Fee Amount: Determines the commission amount that the master account will receive.
Destination: This field is where you enter the IDs of the other accounts to which the payment will be transferred.
For example, if the total payment amount is $1,000 and $100 is entered in the “Application Fee Amount” field:
The master account receives $100 and the remaining $900 is automatically transferred to the “Destination” account.
Use Case: Payment with a Registered Card on a Digital Product Platform
Scenario Flow:
When the user registers on the platform for the first time, they register their card with the Setup Intent.
When they make a purchase for the second time, payment is made directly with the Charge Payment Method action.
If the platform has Stripe Connected Accounts, the payment is automatically redirected to the relevant sub-merchant.
Automatic Subscription Payments: The user's saved payment method can be periodically debited and integrated into the subscription system.
Invoice Automation: After a successful payment, an e-invoice can be generated with e-invoice integration.
Commission Management: In marketplace applications, the Application Fee Amount can be dynamically calculated based on the commission rate.
Use of a Backup Card for Failed Payment Scenarios: If the first card fails, a different registered card can be tried.
Technical Risks
Cannot be used without Setup Intent: This action will not work if there is no registered payment method. The Setup Intent action must be triggered beforehand.
Currency Error: If the Currency parameter does not match the currency defined in your Stripe account, the payment will be declined.
Incorrect Amount Format: The Amount must be entered in small units. For example, 1000 should be entered instead of 10₺ (based on kurus).
Invalid Payment Method ID: An error occurs if a transaction is attempted with a deleted, canceled, or expired card.
Multiple Payments to the Same User: If the payment is triggered repeatedly, the same amount may be charged to the user multiple times. Controlled triggering should be implemented.
Charge Payment Method enables you to process fast, repeatable, and secure payment transactions using registered payment methods in Kuika projects integrated with Stripe. It offers significant convenience, especially for subscription-based models, e-commerce platforms, and marketplaces.
