Gearment API

Order Canceled

EVENT_ORDER_CANCELED is sent when an order is canceled.

When it fires

Fires on an order CDC update when the order status changes to internal cancelled. The delivery body copies the internal order ID, vendor reference, and status.

Example payload

V3

{
  "type": "order_cancelled",
  "order": {
    "gearment_id": "260909P-DEMO01-2D8N6R4W",
    "gearment_name": "260909P-DEMO01-2D8N6R4W",
    "vendor_id": "ETSY-782144",
    "status": "cancelled"
  }
}

V1

{
  "api_key": "ck_demo_8f2c",
  "type": "order_canceled",
  "data": {
    "api_key": "ck_demo_8f2c",
    "gearment_ord_id": "109876544",
    "gearment_ord_name": "260909P-DEMO01-2D8N6R4W",
    "ord_status": "canceled",
    "order_id": "ETSY-782144"
  }
}

Fields

VersionFieldTypePresenceDescription
V1api_keystringADefault credential client key
V1typestringALiteral "order_canceled"
V1dataobjectALegacy payload container
V1data.api_keystringADuplicate default credential client key
V1data.gearment_ord_idstringALegacy numeric ID as a string when mapped; otherwise internal ID
V1data.gearment_ord_namestringAInternal Gearment order ID
V1data.ord_statusstringALiteral "canceled"
V1data.order_idstringA/emptyOrder vendor reference
V3typestringALiteral "order_cancelled"
V3orderobjectAOrder identity and state
V3order.gearment_idstringAInternal Gearment order ID
V3order.gearment_namestringASame internal ID copied into the name field
V3order.vendor_idstringA/emptyOrder vendor reference
V3order.statusstringAInternal status, "cancelled" on this event

Presence: A is always emitted; A/empty is always emitted but the value can be ""; Per item is emitted for every array element.

Verify the signature before parsing the body. See Verifying a payload.

Payload handling

Confirm the exact topic and payload version with the Webhook simulator. Preserve unknown fields, process the event idempotently, and do not depend on JSON property ordering.