Testing & Validation

How to check if your API request processed

All successful new orders, restatements, and cancellations will be available as a new line item for that order in our Commission Detail report. You may access this information using our Commission Detail API or Commission Detail reporting in the CJ Account Manager.

Verifying Your Request Processed

Successful cancellation appear in Commission Detail reporting as two new line items tied to the original order:

• A zero record — a full reversal of the prior order state
• A cancellation record — the new state of the order with all zeroed out values.

You can access this in CJ Account Manager under Commission Detail reporting, or via the Commission Detail API. Processing can take up to an hour. If your cancellation does not appear after that window, contact your CJ team member for assistance.

Processing requests

When your Tracking API request is sent successfully, that request is sent to our order processing system that will validate whether your new order or order change can be processed. This system validates things like the following:

• Does this order already exist in our system?
  • For order restatements and cancellations we must find the order and it must be a commissionable order
• Can this order be restated or cancelled?
  • The order must not be locked or closed
• Does the Action ID belong to the advertiser?
  • The Action ID must belong to same account as the Enterprise ID provided in the request
• Are the requested changes valid?
  • restatements cannot change a commissionable order to be non-commissionable
  • restatements cannot change the publisher who earns a commission
• If the order has an open-ended locking cycle, was a Status field passed in the restatement or cancellation request?
  • The Status field required for all orders with open-ended locking cycles

Processing orders can take up to an hour or longer, and you can see all successful requests in our Commission Detail report or API once processing is complete. If any requests you sent erred out, those changes or new orders will not show in the Commission Detail report or API.

If you need more information on requests that were sent successfully but erred during processing, meaning you are unable to see your changes in Commission Detail reporting, a CJ team member can work with you to provide more details.

Error Handling

Real-Time Validation Errors

Errors are returned immediately for schema, authentication, authorization, and field-level issues. CJ processes errors in this order — fix the first error before expecting to see subsequent ones.

If you receive a 504 error, reduce the number of records to 10,000 or fewer and resubmit.

Processing Errors

Some errors are not returned immediately — they occur when CJ's order processing system evaluates the request after receipt. Common processing failure reasons:

• The order could not be found or is not commissionable
• The order is locked or closed
• The Action Tracker ID does not belong to the advertiser account
• The restatement would change commissionability or publisher attribution
• The order uses open-ended locking but no status field was passed

If a request was accepted but does not appear in Commission Detail reporting after processing, contact your CJ team member for details.