Stripe Split Payments
Get started with Stripe Split Payments via Hyperswitch
Last updated
Was this helpful?
Get started with Stripe Split Payments via Hyperswitch
Last updated
Was this helpful?
Stripe's Split Payments functionality create a charge and split payments between your platform and your sellers or service providers. This feature is supported through their Charge solutions and implemented via Hyperswitch. Hyperswitch facilitates splitting payments during authorization and refund processing, ensuring smooth fund distribution at all transaction stages.
In the payment create request, include the Stripe split rule as provided below.
Parameters
transfer_account_id: Identifier of a Connected Account created using the API or through the Dashboard. {{CONNECTED_ACCOUNT_ID}}
charge_type: It is of two types: 1. : This can be used when customers directly transact with your connected account, often unaware of your platform’s existence. You’d like to choose if Stripe fees are debited from your connected accounts or your platform. 2. : This can be used when customers transact with your platform for products or services provided by your connected account. Stripe fees are debited from your platform account.
application_fees: This attribute specifies the amount your platform deducts from the transaction as an application fee. After the payment is processed on the connected account, the application_fee_amount is transferred to the platform.
Payments Response
In the case of charge typeIn the refund create request, include the following according to your split rule
If "charge_type": "direct"
Parameter:
revert_platform_fee: Boolean
Toggle for reverting the application fee that was collected for the payment. If set to false, the funds are pulled from the destination account.
If "charge_type": "Destination"
Parameter:
revert_platform_fee: Boolean
Indicates whether the application fee should be refunded when refunding this charge.
If a full charge refund is given, the full application fee will be refunded. Otherwise, the application fee will be refunded in an amount proportional to the amount of the charge refunded.
An application fee can be refunded only by the application that created the charge.
revert_transfer: Boolean
Indicates whether the transfer should be reversed when refunding this charge.
The transfer will be reversed proportionally to the amount being refunded (either the entire or partial amount).
A transfer can be reversed only by the application that created the charge
In CIT call, passing customer_id is mandatory. Along with that, the Stripe Split Payments object.
The charge is created on the connect_account 's end and not on the platform. We should pass connect_account_id in transfer_account_id field. If platform_id is passed in transfer_account_id field then no application_fees should not be passed.
The transfer_account_id cannot be platform_account_id. This is because charge cannot be created on your own account itself. Stripe will throw an error.
2. In CIT call, The merchant would also need to pass the customer_acceptance object
3. In the response of the CIT call, the payment_method_id and customer_id received will be used in future MIT calls. Along with that the merchant would need to pass this object as well in the MIT call