Commissions & Payout Overview

3 min

\understanding commissions with wildfire\ wildfire offers both a commission api and callbacks (legacy) to ingest and call on affiliate commissions earned by users merchant commission reporting can vary, as such there are edge cases users need to account for \understanding commission data \ \key response fields\ \what\ \tip\ commissionid commissionid related to the sale ingest and use to reference as a commission moves through a lifecycle saleamount total amount of sale amount total amount of commission (base + boost) this is the cashback rewards earned in total status status of commission/cashback to display to user new commissions will come in as pending wildfire recommends to never payout a user until a status is changed to "ready" tracking code user uuid passed during authentication reference returned uuid, to uuid's attached to user records this is passed to us during authentication or in link creation ensures you map attribution correctly { "commissions" \[ { "commissionid" 1234569625, "applicationid" 0, "merchantid" 1234569625, "deviceid" 0, "devicexid" "0189abef", "saleamount" { "amount" "10 49", "currency" "brl" }, "amounts" \[ { "amount" "0", "currency" "usd", "splitpart" "device", "basecommissionamount" "0", "boostedcommissionamount" "0" } ], "status" "ready", "trackingcode" "012345 6780a bcdef0 50527", "eventdate" "2026 06 15t13 56 03z", "lockingdate" "2026 06 15t13 56 03z", "createddate" "2026 06 15t13 56 03 618187z", "modifieddate" "2026 06 15t14 01 03 618187z", "merchantorderid" "1234513110", "merchantsku" "c62 2770 006 04", "couponcodes" "", "shoppingtripcode" "stc 79066" }, \all commission statuses\ list of all statuses “pending” is the default state of a new commission that is expected to earn a commission amount (i e not disqualified) “confirmed” indicates that the merchant has locked the commission and has committed to making a payment for that individual earning though this signal indicates a commitment from the merchant, it should be viewed the same as the pending status from a risk perspective as no money has changed hands (i e the merchant has not paid the network) note confirmed status was added in v4 of commission records “ready” indicates that the merchant has paid us for the commission and the payment is just awaiting the next payment cycle (at the beginning of each month) “paid” indicates that the record has been paid to the partner (and the user, if wildfire pays users on behalf of the partner), and the commission should be included in the relevant payment report \best practices\ \utilize modified date filters\ instead of paging backward through historical data until a match is found, your system should use the \start modified date\ and \end modified date\ query parameters using the modified date of the last record, you can pass this exact time as the \start modified date\ in your next request \this ensures the api exclusively returns records that have been created or altered since your last pull\ , eliminating the need to page backward and significantly reducing your overall request volume always apply a value for the end modified date; we recommend setting end modified date to the top of the current hour \maximize pagination limits \ to further reduce the number of api calls your job requires, ensure you are maximizing the payload size for each request you can fetch up to \ 2,000 records per call by setting the limit=2000 parameter\ if the number of modified records in your requested date range exceeds 2,000, you can retrieve the complete data set by using the \nextcursor value provided in the response\ to iterate through subsequent pages