Connected Account Payout is an action used with Kuika's Stripe integration. This action allows payments to be made directly and securely from connected accounts on Stripe to users' bank accounts. It is particularly useful for marketplace applications and multi-vendor systems to enable automatic transfer of earnings.
Technical Features
Stripe Connect Integration: Enables payment transfers from connected accounts on the Stripe platform.
Web and Mobile App Support: Can be used in both web and mobile applications developed with Kuika.
Automatic Payment Distribution: Facilitates payment transfers to sellers' bank accounts in revenue sharing systems.
Multi-Currency Support: Works with the currencies defined in your Stripe account.
Connected Account Payout 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 button or event trigger that will trigger the money transfer.
Click on the +ADD ACTION menu in the Properties panel on the right.
Select the button and add the Payment Stripe > Connected Account Payout action from the + ADD ACTION menu according to the desired trigger event (Initial Actions, OnClick, OnBlur, etc.).
Configure the following parameters in the settings that appear:
Amount: Specifies the total amount to be withdrawn from the connected account. The value entered must be in the smallest unit of the selected currency (e.g., 500 for USD = $5.00).
Connected Account: The ID of the connected account on Stripe. It usually starts with acct_ and is obtained from Stripe.
Currency: The currency in which the transaction will take place. It must be the same as the currency defined in your Stripe account (e.g., USD, EUR, TRY).
After filling in all fields, click the Close button to complete the action.
Use Case: Merchant Receives Payment
Scenario: In an e-commerce marketplace application, the merchant wants to transfer their balance to their bank account after making sales.
Scenario Flow:
When the seller clicks the “Receive Payment” button, the Connected Account Payout action is triggered.
The connected account ID and amount on Stripe are dynamically retrieved by the system.
The specified amount is transferred from the Stripe-connected account to the seller's bank account.
The seller is shown the message “Your payment has been successfully sent.”
Dynamic Parameter Retrieval: Values such as Amount and Connected Account can be automatically retrieved from previous actions or the user profile.
Post-Transaction Notification: A confirmation notification can be sent to the user after the money transfer is complete (e.g., toast, email, popup).
Transaction Log and Reporting: The transfer transaction is recorded in the system logs and can be tracked in the admin panel.
Transfer Delay or Scheduling: Payments can be scheduled according to a specific calendar.
Technical Risks
Invalid Connected Account ID: If an incorrect or empty connected account ID is entered, the transaction will not be executed and an error will be returned.
Currency Mismatch: If the selected currency is not defined in your Stripe account, the system may return an error.
Insufficient Balance: If there is insufficient balance in the connected account, the payment transaction will fail.
Stripe Policies: Due to country-specific regulations and Stripe policies, automatic payments may not be possible for some accounts.
Network Delays: If there are temporary disconnections during the connection with Stripe, the transaction may need to be retried.
Connected Account Payout is a powerful action that allows users to withdraw their earnings directly to their bank accounts using Stripe infrastructure. When used in conjunction with the Kuika platform, it automates payment processes, increases user satisfaction, and secures financial transactions.
