Stripe Split Payments

Get started with Stripe Split Payments via Hyperswitch

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.

Split Stripe payments via Hyperswitch

In the payment create request, include the Stripe split rule as provided below.

     "split_payments": {
    	"stripe_split_payment": {
        	"charge_type": "direct",
        	"application_fees": 100,
        	"transfer_account_id": "{{CONNECTED_ACCOUNT_ID}}"
    	}
      }

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. Direct : 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. Destination: 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

    "split_payments": {
        "stripe_split_payment": {
            "charge_id": "ch_3QSzoAIhl7EEkW0O12IPHRiC",
            "charge_type": "direct",
            "application_fees": 100,
            "transfer_account_id": "acct_1PDftAIhl7EEkW0O"
        }
    }

Split Stripe refunds via Hyperswitch

In the case of charge typeIn the refund create request, include the following according to your split rule

1. If "charge_type": "direct"

      "split_refunds": {
    		"stripe_split_refund": {
        		"revert_platform_fee": true
    		}
	}

Parameter:

• revert_platform_fee: Toggle for reverting the application fee that was collected for the payment. If set to false, the funds are pulled from the destination account.

1. If "charge_type": "Destination"

      "split_refunds": {
    		"stripe_split_refund": {
        		"revert_transfer": true
    		}
	}

Parameter:

• revert_transfer: Toggle for reverting the transfer that was made during the charge. If set to false, the funds are pulled from the main platform's account.