Skip to main content

Commission

Auth: Partner API authentication

merchant_commission

Monthly approved commission totals by brand.

Endpoint: https://app.partnerboost.com/api.php?mod=settlement&op=merchant_commission

Required parameters

KeyDescription
tokenChannel API token
begin_dateFormat: YYYY-MM-DD
end_dateFormat: YYYY-MM-DD

Optional parameters

KeyDescription
typeReturn format: json (default) or xml
payment_currencyThe currency used when paying the commission for the brand to you. Available filter: USD, EUR, GBP. Multiple currencies separated by commas.

Return fields

KeyDescription
brand_idBrand ID, a series of numbers, like 66303
mcidUnique identifier for the brand, a series of characters, like ulike0
sale_commSale Commission
settlement_dateDate when commission is approved and ready for you to withdraw
noteThis indicates the time period the amount is generated. It could be sales commission, bonus or paid placement.
settlement_idA unique id indicates approved commission by merchant
payment_currencyThe currency used when paying the commission for the brand to you. Available Filter: USD, EUR, GBP. Multiple currencies separated by commas.

Request:

{
"token": "YOUR_CHANNEL_TOKEN",
"begin_date": "2024-01-01",
"end_date": "2024-01-31",
"payment_currency": "USD"
}

commission_details

Line-item breakdown for a settlement.

Endpoint: https://app.partnerboost.com/api.php?mod=settlement&op=commission_details

Required parameters

KeyDescription
tokenChannel API token
settlement_idA unique id indicates approved commission by merchant

Optional parameters

KeyDescription
typeReturn format: json (default) or xml

Return fields

KeyDescription
brand_idBrand ID, a series of numbers, like 66303
mcidUnique identifier for the brand, a series of characters, like ulike0
merchant_nameBrand Name
order_idOrder ID
order_timeTransaction Time
sale_amountSale Amount
sale_commSale Commission
statusCommission Status
uiduid, your custom tracking variable (tag)
prod_idProduct ID
order_unitOrder Unit Amount
settlement_idA unique id indicates approved commission by merchant
validation_dateDate the transaction validated
noteReason for status change
payment_currencyThe currency used when paying the commission for the brand to you.

Request:

{
"token": "YOUR_CHANNEL_TOKEN",
"settlement_id": "810b2ce13d1a3b640423"
}
Workflow
  1. List settlements with merchant_commission
  2. Drill into each settlement_id with commission_details
  3. Match payouts via payment API