Implementation

Implementation Requirements

1. Automated Locking Solutions

Advertisers must implement automated systems to manage booking status:

  • Automated job scheduling to regularly process pending bookings
  • Systematic locking or cancellation of bookings based on status
  • No manual file processing - eliminates human error and ensures consistency

2. Start Date Tracking

Required vertical parameter that serves multiple purposes:

  • Start of item duration (check-in date/time, arrival date/time, contract start date/time, etc.)
  • Must be in ISO8601 Timestamp formatting (yyyy-mm-ddThh24:mm:ss.sssZ)
  • Example format: 2025-06-24T15:42:07.123Z
  • Sets clear expectations with publishers
  • Enables proactive booking management

3. End Date Time Tracking

Required vertical parameter that serves multiple purposes:

  • End of item duration (check-out date/time, departure date/time, contract end date/time, etc.)
  • Must be in ISO8601 Timestamp formatting (yyyy-mm-ddThh24:mm:ss.sssZ)
  • Example format: 2025-06-24T15:42:07.123Z
  • Example with timezone offset: 2025-06-24T15:42:07.123-05:00
  • Sets clear payment expectations with publishers

Best Practice: When booking end dates change, advertisers should provide restatements to publishers to maintain transparent expectations.

4. CJ Commission Detail API Integration

Advertisers must utilize CJ's Commission Detail API or export functionality to:

  • Identify all bookings tracked through CJ's system
  • Avoid reliance on internal CRM systems alone
  • Ensure comprehensive tracking of all commission-eligible bookings

5. Process Validation and Testing

Required testing includes:

  • Submitting an initial test - Placing a test reservation to initiate the purchase flow
  • Cancellation process validation - Ensure cancelled bookings return a status of "Declined"
  • Restatement process testing - Ensure valid bookings return a status of "Accepted"
  • End-to-end workflow testing - Confirm entire booking lifecycle operates as expected

This validation prevents pending commissions or fees from accumulating on advertiser accounts.

Commission Detail API Page