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 Parameter | Type | Length | Description |
|---|---|---|---|
| extraMerchantData.amount | float, mandatory | 10 | Amount that “payer” (buyer) is paying to single or different vendors charges |
| extraMerchantData.knetCharge | float, mandatory | 2,2 | Merchant’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.knetChargeType | string, mandatory | 10 | Knet charge type (Fixed or Percentage) |
| extraMerchantData.ccCharge | float, mandatory | 2,2 | Merchant’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.ccChargeType | string, mandatory | 10 | CC charge type (Fixed or Percentage) |
| extraMerchantData.ibanNumber | string, array, mandatory | 30 | IBAN 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"
}
]