Orders vs. Commissions

Order-level vs. Order-item level Commission Records: Understanding the Differences

Understanding the relationship between orders and commissions is an important part of any partner integration process. It allows our partner to track earnings and determine the amount of commission that should be paid to users. There are two main types of commission reporting: order-level and order-item level.

Order-Level Commission Reporting

Some merchants provide order-level commission reporting, where entire orders are grouped together as a single record. In these cases, returns are updated as amounts to the existing commission ID. The commission ID remains the same between the initial and updated records, but the modified date and amounts change.

Here is an example of an order-level commission report for an original purchase:

{
  "CommissionID": 31870476,
  "ApplicationID": 104,
  "MerchantID": 5479397,
  "DeviceID": 15319832,
  "SaleAmount": {
    "Amount": "60.99",
    "Currency": "USD"
  },
  "Amounts": [
    {
      "Amount": "1.2500",
      "Currency": "USD",
      "SplitPart": "APPLICATION"
    }
  ],
  "Status": "PENDING",
  "EventDate": "2023-02-02T17:26:55Z",
  "LockingDate": "2023-05-01T05:00:00Z",
  "CreatedDate": "2023-02-02T18:53:58.106991Z",
  "ModifiedDate": "2023-02-02T18:53:58.106991Z",
  "MerchantOrderID": "6327180345",
  "MerchantSKU": ""
}

And here is an example of an order-level commission report for a partial return:

{
  "CommissionID": 31870476,
  "ApplicationID": 104,
  "MerchantID": 5479397,
  "DeviceID": 15319832,
  "SaleAmount": {
    "Amount": "44.96",
    "Currency": "USD"
  },
  "Amounts": [
    {
      "Amount": "0.2925",
      "Currency": "USD",
      "SplitPart": "APPLICATION"
    }
  ],
  "Status": "PENDING",
  "EventDate": "2023-02-02T17:26:55Z",
  "LockingDate": "2023-05-01T05:00:00Z",
  "CreatedDate": "2023-02-02T18:53:58.106991Z",
  "ModifiedDate": "2023-03-25T10:44:56.526455Z",
  "MerchantOrderID": "6327180345",
  "MerchantSKU": ""
}

Order-level initial reporting with order-item level returns

Some merchants will describe the initial purchase as a single record but subsequent returns as separate records. See below how the initial positive amount (purchase) lists all the SKUs in a single record but each of two partial returns are reported as separate records.

{
  "CommissionID": 32753768,
  "ApplicationID": 104,
  "MerchantID": 5507506,
  "DeviceID": 15815011,
  "SaleAmount": {
    "Amount": "163.6",
    "Currency": "USD"
  },
  "Amounts": [
    {
      "Amount": "3.1902",
      "Currency": "USD",
      "SplitPart": "APPLICATION"
    }
  ],
  "Status": "PENDING",
  "EventDate": "2023-03-06T23:24:12Z",
  "LockingDate": "2023-05-05T00:00:00Z",
  "CreatedDate": "2023-03-07T01:17:09.578311Z",
  "ModifiedDate": "2023-03-07T01:17:09.578311Z",
  "MerchantOrderID": "4042006870",
  "MerchantSKU": "99104147967,99104150039,99106898030,99106898040,99106898090,99107014510"
}

And here is an example of an order-item level commission report for a partial return:

{
  "CommissionID": 32910383,
  "ApplicationID": 104,
  "MerchantID": 5507506,
  "DeviceID": 15815011,
  "SaleAmount": {
    "Amount": "-31.6",
    "Currency": "USD"
  },
  "Amounts": [
    {
      "Amount": "-0.6162",
      "Currency": "USD",
      "SplitPart": "APPLICATION"
    }
  ],
  "Status": "PENDING",
  "EventDate": "2023-03-06T23:24:12Z",
  "LockingDate": "2023-05-05T00:00:00Z",
  "CreatedDate": "2023-03-14T12:19:50.66962Z",
  "ModifiedDate": "2023-03-14T12:19:50.66962Z",
  "MerchantOrderID": "4042006870",
  "MerchantSKU": "99104150039"
}

Conclusion

Wildfire Systems is trying hard to make merchant data more normalized and though we have tried to standardize around order-item level reporting, some merchants don't provide enough detail to allow us to do that. We are actively considering ways to make the data more normalized, including standardizing around order-level reporting. In the meantime, it's appropriate to design your systems in such a way that they can work with the aforementioned use cases and reach out to us if you have any questions.

Updated 16 Jun 2026