---
updatedAt: 2026-09-28T16:09:28.000Z
agentTools:
  projectIndex: https://docs.cj.com/llms.txt
---

# Cancellations

# How cancellations work

Order Cancellations allow you to cancel an existing order previously accepted into the CJ system. This concept is similar to what CJ has traditionally called a "full correction" for Advertisers using our batch corrections process.

<PreflightNote
  items={[
    "When you request to cancel an order, CJ will process the cancellation and adjust the sale amount, item quantities, publisher commission, and CJ fee to '0'.",
    "If the order you intend to cancel uses open-ended locking, you must pass an order status of 'Declined' in the cancelOrders request.",
    "You may pass an optional Correction Reason with an order cancellation request."
  ]}
/>

# Rules for using cancellations

export const CancellationEligibility = () => (

  <div style={{ fontFamily: "'DM Sans', sans-serif", color: "#1e293b", padding: "0 0 1rem" }}>

    <style>{`

      .ce-grid {
        display: grid;
        grid-template-columns: 1fr 1fr;
        gap: 12px;
        margin: 0 0 4px;
      }
      @media (max-width: 580px) {
        .ce-grid { grid-template-columns: 1fr; }
      }
      .ce-card {
        border: 1px solid #e2e8f0;
        border-radius: 12px;
        overflow: hidden;
      }
      html[data-color-mode="dark"] .ce-card {
        border-color: rgba(51, 65, 85, 0.5);
      }
      .ce-card-header {
        display: flex;
        align-items: center;
        gap: 10px;
        padding: 14px 16px;
        border-bottom: 1px solid #e2e8f0;
        background: #f8fafc;
      }
      html[data-color-mode="dark"] .ce-card-header {
        background: #1e293b;
        border-bottom-color: rgba(51, 65, 85, 0.5);
      }
      .ce-card-icon {
        width: 22px;
        height: 22px;
        border-radius: 50%;
        display: flex;
        align-items: center;
        justify-content: center;
        flex-shrink: 0;
      }
      .ce-card-title {
        font-size: 13px;
        font-weight: 600;
        color: #0f172a;
        flex-grow: 1;
      }
      html[data-color-mode="dark"] .ce-card-title {
        color: #f1f5f9;
      }
      .ce-card-tag {
        font-family: 'DM Mono', monospace;
        font-size: 9px;
        font-weight: 600;
        letter-spacing: 0.08em;
        text-transform: uppercase;
        padding: 3px 8px;
        border-radius: 4px;
      }
      .ce-card-tag.allow {
        color: #007e4d;
        background: #f2fffa;
        border: 1px solid #007e4d;
      }
      .ce-card-tag.deny {
        color: #d42617;
        background: #fff7f4;
        border: 1px solid #d42617;
      }
      html[data-color-mode="dark"] .ce-card-tag.allow {
        color: #4db88a;
        background: rgba(0, 126, 77, 0.1);
        border-color: rgba(0, 126, 77, 0.4);
      }
      html[data-color-mode="dark"] .ce-card-tag.deny {
        color: #ff7a6e;
        background: rgba(212, 38, 23, 0.1);
        border-color: rgba(212, 38, 23, 0.4);
      }
      .ce-card-body {
        padding: 16px 18px;
        background: #ffffff;
      }
      html[data-color-mode="dark"] .ce-card-body {
        background: #0f172a;
      }
      .ce-list {
        margin: 0;
        padding: 0;
        list-style: none;
        display: flex;
        flex-direction: column;
        gap: 12px;
      }
      .ce-item {
        display: flex;
        align-items: flex-start;
        gap: 10px;
        font-size: 13px;
        line-height: 1.6;
        color: #475569;
      }
      html[data-color-mode="dark"] .ce-item {
        color: #94a3b8;
      }
      .ce-item-icon {
        flex-shrink: 0;
        margin-top: 2px;
      }
      .ce-item-content {
        flex-grow: 1;
      }
      .ce-item-label {
        font-weight: 600;
        color: #0f172a;
        display: block;
        margin-bottom: 2px;
      }
      html[data-color-mode="dark"] .ce-item-label {
        color: #f1f5f9;
      }
      .ce-item-code {
        font-family: 'DM Mono', monospace;
        font-size: 11px;
        background: #f2f0f9;
        color: #3d2c7d;
        padding: 1px 5px;
        border-radius: 3px;
        border: 1px solid #dddddd;
        white-space: nowrap;
      }
      html[data-color-mode="dark"] .ce-item-code {
        background: rgba(61, 44, 125, 0.2);
        color: #b9a8ff;
        border-color: rgba(61, 44, 125, 0.4);
      }
    `}</style>

    <div className="ce-grid">

      {/* What You Can Cancel */}
      <div className="ce-card">
        <div className="ce-card-header">
          <div className="ce-card-icon">
            <svg width="18" height="18" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
              <circle cx="12" cy="12" r="10" stroke="#007e4d" strokeWidth="1.8" />
              <path d="M8 12l3 3 5-5" stroke="#007e4d" strokeWidth="1.8" strokeLinecap="round" strokeLinejoin="round" />
            </svg>
          </div>
          <span className="ce-card-title">What you can cancel</span>
          <span className="ce-card-tag allow">Eligible</span>
        </div>
        <div className="ce-card-body">
          <ul className="ce-list">

            <li className="ce-item">
              <svg className="ce-item-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M5 12l5 5L20 7" stroke="#007e4d" strokeWidth="2.2" strokeLinecap="round" strokeLinejoin="round" />
              </svg>
              <div className="ce-item-content">
                <span className="ce-item-label">Commissionable orders</span>
                Only orders recorded as commissionable in CJ's system are eligible for cancellation.
              </div>
            </li>

            <li className="ce-item">
              <svg className="ce-item-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M5 12l5 5L20 7" stroke="#007e4d" strokeWidth="2.2" strokeLinecap="round" strokeLinejoin="round" />
              </svg>
              <div className="ce-item-content">
                <span className="ce-item-label">Open orders</span>
                Orders that are not locked or closed at the time the cancellation request is submitted.
              </div>
            </li>

            <li className="ce-item">
              <svg className="ce-item-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M5 12l5 5L20 7" stroke="#007e4d" strokeWidth="2.2" strokeLinecap="round" strokeLinejoin="round" />
              </svg>
              <div className="ce-item-content">
                <span className="ce-item-label">Any tracking method</span>
                Orders captured through Universal Tag, Tracking API, Data File Import, or Server-to-Server Postback.
              </div>
            </li>

          </ul>
        </div>
      </div>

      {/* What a Cancellation Cannot Do */}
      <div className="ce-card">
        <div className="ce-card-header">
          <div className="ce-card-icon">
            <svg width="18" height="18" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
              <circle cx="12" cy="12" r="10" stroke="#d42617" strokeWidth="1.8" />
              <path d="M8 8l8 8M16 8l-8 8" stroke="#d42617" strokeWidth="1.8" strokeLinecap="round" />
            </svg>
          </div>
          <span className="ce-card-title">What cancellation can't do</span>
          <span className="ce-card-tag deny">Restricted</span>
        </div>
        <div className="ce-card-body">
          <ul className="ce-list">

            <li className="ce-item">
              <svg className="ce-item-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M6 6l12 12M18 6L6 18" stroke="#d42617" strokeWidth="2.2" strokeLinecap="round" />
              </svg>
              <div className="ce-item-content">
                <span className="ce-item-label">Modify order attributes</span>
                Cancellations do not accept attribute changes. To update order details before cancelling, submit a <span className="ce-item-code">restateOrders</span> request first.
              </div>
            </li>

            <li className="ce-item">
              <svg className="ce-item-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M6 6l12 12M18 6L6 18" stroke="#d42617" strokeWidth="2.2" strokeLinecap="round" />
              </svg>
              <div className="ce-item-content">
                <span className="ce-item-label">Combine operations</span>
                The cancellation request identifies the target order by its key fields; CJ's system processes the cancellation against the existing record as-is.
              </div>
            </li>

            <li className="ce-item">
              <svg className="ce-item-icon" width="14" height="14" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
                <path d="M6 6l12 12M18 6L6 18" stroke="#d42617" strokeWidth="2.2" strokeLinecap="round" />
              </svg>
              <div className="ce-item-content">
                <span className="ce-item-label">Reverse a cancellation</span>
                Once a cancellation is processed, it cannot be undone through the API. Resubmit the order as a new transaction if needed.
              </div>
            </li>

          </ul>
        </div>
      </div>

    </div>

  </div>

);

<CancellationEligibility />

# How to send cancellations

import React from 'react';

export const CancellationsOptions = ({
  apiHref = "/docs/cancellations-api",
  fileHref = "/docs/cancellations-datafile",
}) => (
<>

    <style>{`
      /* ─── Root ──────────────────────────────────────────── */
      .co-root {
        font-family: DM Sans, sans-serif;
        padding: 0 0 1rem;
      }

      /* ─── Header ────────────────────────────────────────── */
      .co-header {
        margin-bottom: 20px;
      }
      .co-header-title {
        font-size: 14px;
        font-weight: 600;
        color: #0f172a;
        margin: 0 0 3px;
        letter-spacing: -0.01em;
      }
      .co-header-sub {
        font-size: 12px;
        color: #64748b;
        margin: 0;
        line-height: 1.5;
      }

      /* ─── Grid ──────────────────────────────────────────── */
      .co-grid {
        display: grid;
        grid-template-columns: 1fr auto 1fr;
        gap: 0;
        align-items: center;
      }

      /* ─── OR divider ────────────────────────────────────── */
      .co-or-wrap {
        display: flex;
        flex-direction: column;
        align-items: center;
        gap: 8px;
        padding: 0 16px;
      }
      .co-or-vline {
        width: 1px;
        height: 40px;
        background: #e2e8f0;
      }
      .co-or-badge {
        font-family: DM Mono, monospace;
        font-size: 10px;
        font-weight: 600;
        letter-spacing: 0.07em;
        text-transform: uppercase;
        color: #94a3b8;
        background: #f8fafc;
        border: 1px solid #e2e8f0;
        padding: 3px 8px;
        border-radius: 100px;
      }

      /* ─── Card ──────────────────────────────────────────── */
      .co-card {
        display: block;
        text-decoration: none !important;
        border: 1px solid #e2e8f0;
        border-radius: 12px;
        padding: 20px;
        background: #ffffff;
        transition: border-color 0.18s ease, box-shadow 0.18s ease, background 0.18s ease;
        cursor: pointer;
        align-self: stretch;
      }
      .co-card:hover {
        border-color: #dddddd;
        background: #f8fafc;
        box-shadow: 0 4px 16px rgba(61, 44, 125, 0.07);
        text-decoration: none !important;
      }

      /* ─── Card top row ──────────────────────────────────── */
      .co-card-top {
        display: flex;
        align-items: flex-start;
        justify-content: space-between;
        gap: 10px;
        margin-bottom: 14px;
      }
      .co-icon-ring {
        width: 40px;
        height: 40px;
        border-radius: 10px;
        display: flex;
        align-items: center;
        justify-content: center;
        flex-shrink: 0;
        background: #f2f0f9;
        border: 1px solid #dddddd;
      }
      .co-arrow {
        color: #cbd5e1;
        transition: color 0.15s ease, transform 0.15s ease;
        margin-top: 2px;
        flex-shrink: 0;
      }
      .co-card:hover .co-arrow {
        color: #3d2c7d;
        transform: translateX(2px);
      }

      /* ─── Card body ─────────────────────────────────────── */
      .co-option-num {
        font-family: DM Mono, monospace;
        font-size: 10px;
        font-weight: 600;
        letter-spacing: 0.08em;
        text-transform: uppercase;
        color: #94a3b8;
        margin: 0 0 4px;
      }
      .co-card-title {
        font-size: 14px;
        font-weight: 600;
        color: #0f172a;
        margin: 0 0 8px;
        letter-spacing: -0.01em;
        line-height: 1.3;
      }
      .co-card-desc {
        font-size: 12px;
        color: #475569;
        line-height: 1.6;
        margin: 0 0 14px;
      }

      /* ─── Tag pills ─────────────────────────────────────── */
      .co-tags {
        display: flex;
        flex-wrap: wrap;
        gap: 5px;
      }
      .co-tag {
        font-family: DM Mono, monospace;
        font-size: 10px;
        font-weight: 500;
        color: #3d2c7d;
        background: #f2f0f9;
        border: 1px solid #dddddd;
        padding: 2px 8px;
        border-radius: 4px;
        white-space: nowrap;
      }

      /* ─── Dark mode ─────────────────────────────────────── */
      html[data-color-mode="dark"] .co-header-title  { color: #f1f5f9; }
      html[data-color-mode="dark"] .co-header-sub    { color: #94a3b8; }
      html[data-color-mode="dark"] .co-or-vline      { background: rgba(51, 65, 85, 0.5); }
      html[data-color-mode="dark"] .co-or-badge      { background: #0f172a; border-color: rgba(51, 65, 85, 0.6); color: #64748b; }
      html[data-color-mode="dark"] .co-card          { background: #1e293b; border-color: rgba(51, 65, 85, 0.6); }
      html[data-color-mode="dark"] .co-card:hover    { background: #273548; border-color: #a0bff5; box-shadow: 0 4px 16px rgba(0, 0, 0, 0.3); }
      html[data-color-mode="dark"] .co-icon-ring     { background: rgba(61, 44, 125, 0.2); border-color: rgba(61, 44, 125, 0.4); }
      html[data-color-mode="dark"] .co-option-num    { color: #64748b; }
      html[data-color-mode="dark"] .co-card-title    { color: #e2e8f0; }
      html[data-color-mode="dark"] .co-card-desc     { color: #94a3b8; }
      html[data-color-mode="dark"] .co-tag           { background: rgba(61, 44, 125, 0.2); border-color: rgba(61, 44, 125, 0.35); color: #a0bff5; }
      html[data-color-mode="dark"] .co-arrow         { color: rgba(51, 65, 85, 0.7); }
      html[data-color-mode="dark"] .co-card:hover .co-arrow { color: #a0bff5; }
    `}</style>

    <div className="co-root">

      <div className="co-header">
        <p className="co-header-title">How would you like to send cancellations?</p>
        <p className="co-header-sub">Choose the method that fits your existing infrastructure. Both options remove commission liability for cancelled or returned orders.</p>
      </div>

      <div className="co-grid">

        <a className="co-card" href={apiHref} target="_blank" rel="noopener noreferrer">
          <div className="co-card-top">
            <div className="co-icon-ring">
              <svg width="20" height="20" viewBox="0 0 20 20" fill="none">
                <rect x="2" y="4" width="16" height="12" rx="2" stroke="#3d2c7d" strokeWidth="1.3"/>
                <path d="M7 8 L5 10 L7 12" stroke="#3d2c7d" strokeWidth="1.3" strokeLinecap="round" strokeLinejoin="round"/>
                <path d="M13 8 L15 10 L13 12" stroke="#3d2c7d" strokeWidth="1.3" strokeLinecap="round" strokeLinejoin="round"/>
                <path d="M11 7 L9 13" stroke="#3d2c7d" strokeWidth="1.3" strokeLinecap="round"/>
              </svg>
            </div>
            <svg className="co-arrow" width="16" height="16" viewBox="0 0 16 16" fill="none">
              <path d="M3 8 H13 M9 4 L13 8 L9 12" stroke="currentColor" strokeWidth="1.4" strokeLinecap="round" strokeLinejoin="round"/>
            </svg>
          </div>
          <p className="co-option-num">Option 1</p>
          <p className="co-card-title">Cancellations API</p>
          <p className="co-card-desc">Send cancellations in real time using CJ's GraphQL API. Ideal for teams with a server-side integration or a CDP like Tealium EventStream.</p>
          <div className="co-tags">
            <span className="co-tag">GraphQL</span>
            <span className="co-tag">Real-time</span>
            <span className="co-tag">Server-side</span>
          </div>
        </a>

        <div className="co-or-wrap">
          <div className="co-or-vline" />
          <span className="co-or-badge">or</span>
          <div className="co-or-vline" />
        </div>

        <a className="co-card" href={fileHref} target="_blank" rel="noopener noreferrer">
          <div className="co-card-top">
            <div className="co-icon-ring">
              <svg width="20" height="20" viewBox="0 0 20 20" fill="none">
                <path d="M5 3 H12 L16 7 V17 A1 1 0 0 1 15 18 H5 A1 1 0 0 1 4 17 V4 A1 1 0 0 1 5 3 Z" stroke="#3d2c7d" strokeWidth="1.3" strokeLinejoin="round"/>
                <path d="M12 3 V7 H16" stroke="#3d2c7d" strokeWidth="1.3" strokeLinejoin="round"/>
                <path d="M7 11 H13 M7 14 H11" stroke="#3d2c7d" strokeWidth="1.2" strokeLinecap="round"/>
              </svg>
            </div>
            <svg className="co-arrow" width="16" height="16" viewBox="0 0 16 16" fill="none">
              <path d="M3 8 H13 M9 4 L13 8 L9 12" stroke="currentColor" strokeWidth="1.4" strokeLinecap="round" strokeLinejoin="round"/>
            </svg>
          </div>
          <p className="co-option-num">Option 2</p>
          <p className="co-card-title">Cancellations Data File</p>
          <p className="co-card-desc">Submit cancellations in bulk via SFTP or manual upload. Best for teams that already use batch data exports or scheduled file transfers.</p>
          <div className="co-tags">
            <span className="co-tag">Batch</span>
            <span className="co-tag">SFTP</span>
            <span className="co-tag">Scheduled</span>
          </div>
        </a>

      </div>

    </div>
  </>
);

<CancellationsOptions apiHref="/docs/cancellations-api" fileHref="/docs/cancellations-datafile" />