Extension File

CJ's extension data transfer enables advertisers to extend large numbers of transactions at once, rather than extending them individually inside CJ Account Manager. This is useful when a program's correction window needs to be extended for transactions from a prior month, allowing more time for returns or other reconciliation activity to be processed before publishers are paid.

Extension files must be processed by the 10th of the current month for transactions that occurred in the prior calendar month. Submit your files as early as possible before this deadline to ensure successful and timely processing.


📋Before You Implement
  • Only transactions in a NEW or ACCEPTED state can be extended. Transactions in a LOCKED or CORRECTED state cannot be extended and will be rejected.
  • Extension data files for prior-month transactions must be received and processed by the 10th of the current month. Submit early to avoid missing the deadline.
  • You must have an active extension data subscription configured with CJ before you can submit files. Contact your CJ account representative to obtain your Subscription ID (SUBID).
  • Each record must include at least one of TID (CJ Transaction ID) or OID (Advertiser Order ID). If you provide only an OID, it must be unique per transaction.

How Transaction Extension Works

When CJ processes an extension data file, it extends the correction window for each transaction identified in the file. This gives the advertiser additional time to submit correction data against those transactions before publishers are locked and paid.

Each record in the file identifies a transaction by its CJ Transaction ID (TID), its advertiser-supplied Order ID (OID), or both. If both values are supplied in a record, the TID takes precedence for matching.


Eligible Transaction States

Only transactions currently in one of the following states can be extended:

  • NEW: The transaction has been posted but has not yet been reviewed.
  • ACCEPTED: The transaction has been reviewed and accepted but has not yet been locked for payment.

Attempting to extend a transaction in a LOCKED or CORRECTED state will result in a rejection. Verify transaction states in CJ Account Manager before building your extension file.


Submission Deadline

Extension files covering prior-month transactions must be processed by the 10th of the current month. Because processing time is required after file receipt, submit your files well before the deadline.

If your correction period routinely requires more time than a single monthly extension provides, contact your CJ account representative to discuss your options.


Supported File Formats

Extension data files are accepted in the following formats:

  • Comma-delimited (CSV)
  • Tab-delimited
  • Pipe-delimited

See the Implementation page for field definitions, format requirements, and record examples.



What’s Next