Overview

Merchants who have multiple sub-vendors can take advantage of the Multi-vendor API option. To do so, the merchant should have a UPay account with proper details in the "My Account" section. Once the details are verified, deposits can be made.

To enable the Multi-vendor API option, you need to define an array called "ExtraMerchantsData" while creating the payment request. This will allow you to include additional information about the sub-vendors and enable the multi-vendor functionality. By using this option, you can easily manage payments for multiple sub-vendors within the same transaction.

Request Model

The request is a POST request with the following parameters:

Input ParameterTypeLengthDescription
extraMerchantData.amountfloat, mandatory10Amount that “payer” (buyer) is paying to single or different vendors charges
extraMerchantData.knetChargefloat, mandatory2,2Merchant’s Knet charge rate for the sub vendor. Define your fees here. This the merchant's commission from each transaction from the sub-vendor.
extraMerchantData.knetChargeTypestring, mandatory10Knet charge type (Fixed or Percentage)
extraMerchantData.ccChargefloat, mandatory2,2Merchant’s Credit Card charge rate for the sub-vendor. Define your fees here. This is the merchants' commission from each transaction from the sub-vendor. (Includes MasterCard, Visa, Samsung Pay, Google Pay, and Apple Pay)
extraMerchantData.ccChargeTypestring, mandatory10CC charge type (Fixed or Percentage)
extraMerchantData.ibanNumberstring, array, mandatory30IBAN Numbers of different vendors
"extraMerchantData": [
	{
		"amount": 10,
		"knetCharge": 5,
		"knetChargeType": "fixed",
		"ccCharge": 10,
		"ccChargeType": "percentage",
		"ibanNumber": "KW91KFHO0000000000051010173254"
	},
	{
		"amount": 10,
		"knetCharge": 5,
		"knetChargeType": "fixed",
		"ccCharge": 7,
		"ccChargeType": "percentage",
		"ibanNumber": "KW31NBOK0000000000002010177457"
	}
]