website logo
WildlinkWildfire-corpFeaturesNetworkCompanyPricingResourcesContact us
⌘K
Partner Admin
Commission History
Performance Summary
Desktop Solutions
Browser Extension Authentication
Implementing Wildfire Coupons into an existing Chrome Extension
How to Implement OAuth in a Chrome Extension
Direct tracking code injection to extension
Mobile Solutions
Android MCA SDK Guide
Android MCA Permission Compliance
How to implement the Mobile Safari Extension
Wildfire APIs
Country filtering and multiple applications
Public Commission Sample Data
Getting to know the Wildfire JSON Data Feeds
Creating links
Gift Card
Merchants and Domains
Merchant Images
Tracking Code (TC) Parameter
Syncing Commission Data via API and Callbacks
Working with Wildfire Coupon Data
Getting started with the Wildfire API Postman collection
FAQ and General Resources
Orders vs. Commissions
Understanding Our Data Collection and Use
Jump Track
Best Practices
6 Reasons Why a User Might Not Get Credit for Earning
FTC Compliance Overview
Stand-Down Policy Compliance
Docs powered by archbee 

Orders vs. Commissions

10min

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:

JSON
|
{
    "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:

JSON
|
{
    "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": ""
}


Note that in this case the CommissionID and the MerchantOrderID (aka the Order ID) stays the same and only the SaleAmount and Amount (aka the Commission Amount) and ModifiedDate change to reflect the updated order.

Most merchants, on the other hand, provide order-item level commission reporting. In this method, every item in an order is posted as a separate commission record. Items and returns are recorded separately, each with their order-item amounts and a separate commission ID. This method is often referred to as "ledger-style."

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

JSON
|
{
     "CommissionID": 32736944,
     "ApplicationID": 156,
     "MerchantID": 5479868,
     "DeviceID": 18156054,
     "SaleAmount": {
         "Amount": "67.99",
         "Currency": "USD"
     },
     "Amounts": [
         {
             "Amount": "1.632",
             "Currency": "USD",
             "SplitPart": "APPLICATION"
         }
     ],
     "Status": "PENDING",
     "EventDate": "2023-03-04T21:04:00Z",
     "LockingDate": "0001-01-01T00:00:00Z",
     "CreatedDate": "2023-03-06T15:24:36.611096Z",
     "ModifiedDate": "2023-03-07T02:57:58.5251Z",
     "MerchantOrderID": "M2673245040",
     "MerchantSKU": "15406898"
 },
 {
     "CommissionID": 32736945,
     "ApplicationID": 156,
     "MerchantID": 5479868,
     "DeviceID": 18156054,
     "SaleAmount": {
         "Amount": "109",
         "Currency": "USD"
     },
     "Amounts": [
         {
             "Amount": "2.616",
             "Currency": "USD",
             "SplitPart": "APPLICATION"
         }
     ],
     "Status": "PENDING",
     "EventDate": "2023-03-04T21:04:00Z",
     "LockingDate": "0001-01-01T00:00:00Z",
     "CreatedDate": "2023-03-06T15:24:37.236906Z",
     "ModifiedDate": "2023-03-07T02:58:07.931103Z",
     "MerchantOrderID": "M2673245040",
     "MerchantSKU": "15453724"
 }


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

JSON
|
{
     "CommissionID": 33556694,
     "ApplicationID": 156,
     "MerchantID": 5479868,
     "DeviceID": 18156054,
     "SaleAmount": {
         "Amount": "-109",
         "Currency": "USD"
     },
     "Amounts": [
         {
             "Amount": "-2.616",
             "Currency": "USD",
             "SplitPart": "APPLICATION"
         }
     ],
     "Status": "PENDING",
     "EventDate": "2023-03-04T21:04:00Z",
     "LockingDate": "0001-01-01T00:00:00Z",
     "CreatedDate": "2023-04-01T23:40:45.361252Z",
     "ModifiedDate": "2023-04-01T23:40:45.361252Z",
     "MerchantOrderID": "M2673245040",
     "MerchantSKU": "15453724"
 }


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.

JSON
|
  {
     "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:

JSON
|
 {
     "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 11 May 2023
Did this page help you?
Yes
No
PREVIOUS
Getting started with the Wildfire API Postman collection
NEXT
Understanding Our Data Collection and Use
Docs powered by archbee 
TABLE OF CONTENTS
Order-level vs. Order-item level Commission Records: Understanding the Differences
Order-Level Commission Reporting
Order-level initial reporting with order-item level returns
Conclusion