Connected Account Withdraw is an action used with Kuika's Stripe integration. This action allows users to manually or automatically withdraw funds from their connected accounts on Stripe to their own bank accounts. It is ideal for systems with marketplaces or multiple sellers to allow users to distribute their earnings.
Technical Features
Stripe Connect Compatible: Enables fund withdrawals from Stripe connected accounts.
Web and Mobile App Support: The action is available on both web and mobile apps.
Real-Time Transfer: Directly transfers funds to the bank account defined by Stripe.
Secure Transaction Flow: Provides a secure withdrawal process via the Stripe API.
Select and open your project from the Apps screen.
Select the UI component that will initiate the withdrawal process (e.g., “Transfer to My Account” button).
Click on the +ADD ACTION menu in the Properties panel on the right.
Select the button and add the Payment Stripe > Connected Account Withdraw action from the + ADD ACTION menu according to the desired trigger event (Initial Actions, OnClick, OnBlur, etc.).
Enter the following parameters in the settings that appear:
Amount: Specifies the amount to be withdrawn from the connected account. The amount entered must be in the smallest unit of the selected currency (e.g., 1000 = $10.00 for USD).
Connected Account: The ID of the Stripe-connected account from which the withdrawal will be made. It usually starts with acct_ and is obtained from the Stripe platform.
Currency: Specifies the currency in which the withdrawal will be made. This value must be a currency defined in your Stripe account (e.g., USD, TRY, EUR).
After filling in the information, click the Close button to complete the action.
Use Case: Merchant Withdrawing Balance
Scenario: In a marketplace application, a merchant wants to withdraw the revenue earned from their sales to their bank account.
Scenario Flow:
The merchant clicks the “Withdraw My Balance” button.
The Connected Account Withdraw action associated with this button is triggered.
The specified amount is transferred from the connected account on Stripe to the seller's bank account.
After a successful transaction, the user sees the message “Your withdrawal was successful.”
Dynamic Data Usage: The Amount and Connected Account values can be dynamically retrieved from the user profile or previous action results.
Minimum Limit Check: Conditional validation can be added to prevent transactions below a certain amount.
Currency Conversion Warning: Notification can be provided if the withdrawal is to be made in a different country/currency.
Transaction Notification: An email or mobile notification can be sent to the user after the withdrawal is completed.
Transaction Log: Transactions can be logged in the admin panel.
Technical Risks
Insufficient Balance: If there is insufficient balance in the linked account, the transaction will fail.
Incorrect Account ID: An action will return an error if an invalid or incomplete Connected Account ID is entered.
Currency Mismatch: If a currency not defined in your Stripe account is selected, the transaction will not be processed.
Stripe Transaction Delay: Due to Stripe API delays, the transaction result may be delayed; the user should be notified with a “waiting” message.
Transfer Delays (Banking Processes): Even if Stripe initiates the transaction, the user should be patiently informed in cases where the transfer reaches the bank late.
Connected Account Withdraw enables secure and fast withdrawal transactions in multi-user systems integrated with Stripe. It can be easily configured on Kuika and offers a customized financial experience to sellers.
