---
title: "Cancellation request for fulfillment order"
description: "Submit a cancel request for the fulfillment order"
doc_type: openapi
doc_category: openapi
doc_version: v20270301
source_url:
  html: 'https://developer.shopline.com/docs/webhook/order/cancellation-request-for-fulfillment-order'
  md: 'https://developer.shopline.com/docs/webhook/order/cancellation-request-for-fulfillment-order.md'
---
# Cancellation request for fulfillment order

Submit a cancel request for the fulfillment order 

- **API Version:** v20270301
- **API Type:** Webhook
- **API Protocol:** RESTful

## Request

### Request Headers

* `X-Shopline-Topic`

  string (required)

  The unique identifier for the event.

* `X-Shopline-Hmac-Sha256`

  string (required)

  The signature of the request. Upon receiving the request, you must [verify the signature](https://developer.shopline.com/docs/apps/api-instructions-for-use/generate-and-verify-signatures.md#post-requests) to confirm the authenticity and integrity of the data.

* `X-Shopline-Shop-Domain`

  string (required)

  The store domain.

* `X-Shopline-Shop-Id`

  string (required)

  The store ID.

* `X-Shopline-Merchant-Id`

  string (required)

  The merchant ID.

* `X-Shopline-API-Version`

  string (required)

  The API version.

* `X-Shopline-Webhook-Id`

  string (required)

  The ID of this Webhook event.

### Request Body

* `fulfillment_order`

  object

  Information on the order

  * `fulfillment_order_merchant_request`

    object

    Information for request for the order

    * `message`

      string

      Notes

  * `id`

    string

    Identifies id

  * `request_status`

    string

    Status of request for the order

  * `status`

    string

    Tracking order status

## Response

### Status Codes

* `200`

  After receiving a webhook notification from SHOPLINE, you must respond with the following format: 
  
  ``` HTTP/1.1 200 OK ```
  
  For more information about how to subscribe to webhooks and webhook response rules, refer to [Webhook overview](https://developer.shopline.com/docs/apps/api-instructions-for-use/webhooks/overview.md).

### Response Body

#### 200

_No response body_

## OpenAPI Definition

```json
{
  "description": "Submit a cancel request for the fulfillment order ",
  "externalDocs": {
    "description": "| Event Group | Event Identification |\n| :------: | :------: |\n|fulfillment_order        |fulfillment_order/cancellation_request_submitted        |\n",
    "url": "",
    "errorTableDescription": ""
  },
  "operationId": "FziXPzp3",
  "parameters": [
    {
      "name": "X-Shopline-Topic",
      "in": "header",
      "description": "The unique identifier for the event.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Topic",
        "description": "The unique identifier for the event.",
        "type": "string",
        "example": "orders/edited"
      },
      "example": "orders/edited"
    },
    {
      "name": "X-Shopline-Hmac-Sha256",
      "in": "header",
      "description": "The signature of the request. Upon receiving the request, you must [verify the signature](https://developer.shopline.com/docs/apps/api-instructions-for-use/generate-and-verify-signatures.md#post-requests) to confirm the authenticity and integrity of the data.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Hmac-Sha256",
        "description": "The signature of the request. Upon receiving the request, you must [verify the signature](https://developer.shopline.com/docs/apps/api-instructions-for-use/generate-and-verify-signatures.md#post-requests) to confirm the authenticity and integrity of the data.",
        "type": "string",
        "example": "XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM="
      },
      "example": "XWmrwMey6OsLMeiZKwP4FppHH3cmAiiJJAweH5Jo4bM="
    },
    {
      "name": "X-Shopline-Shop-Domain",
      "in": "header",
      "description": "The store domain.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Shop-Domain",
        "description": "The store domain.",
        "type": "string",
        "example": "example.myshopline.com"
      },
      "example": "example.myshopline.com"
    },
    {
      "name": "X-Shopline-Shop-Id",
      "in": "header",
      "description": "The store ID.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Shop-Id",
        "description": "The store ID.",
        "type": "string",
        "example": "1610418123456"
      },
      "example": "1610418123456"
    },
    {
      "name": "X-Shopline-Merchant-Id",
      "in": "header",
      "description": "The merchant ID.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Merchant-Id",
        "description": "The merchant ID.",
        "type": "string",
        "example": "2000001234"
      },
      "example": "2000001234"
    },
    {
      "name": "X-Shopline-API-Version",
      "in": "header",
      "description": "The API version.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-API-Version",
        "description": "The API version.",
        "type": "string",
        "example": "v20250601"
      },
      "example": "v20250601"
    },
    {
      "name": "X-Shopline-Webhook-Id",
      "in": "header",
      "description": "The ID of this Webhook event.",
      "required": true,
      "style": "string",
      "schema": {
        "name": "X-Shopline-Webhook-Id",
        "description": "The ID of this Webhook event.",
        "type": "string",
        "example": "b54557e48a5fbf7d70bcd043"
      },
      "example": "b54557e48a5fbf7d70bcd043"
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "properties": {
            "fulfillment_order": {
              "name": "fulfillment_order",
              "description": "Information on the order",
              "type": "object",
              "properties": {
                "fulfillment_order_merchant_request": {
                  "name": "fulfillment_order_merchant_request",
                  "description": "Information for request for the order",
                  "type": "object",
                  "properties": {
                    "message": {
                      "name": "message",
                      "description": "Notes",
                      "type": "string",
                      "example": "\"cancel order\""
                    }
                  },
                  "example": {
                    "message": "\"cancel order\""
                  }
                },
                "id": {
                  "name": "id",
                  "description": "Identifies id",
                  "type": "string",
                  "example": "\"21057401932826316666967110_4005740193290131085320\""
                },
                "request_status": {
                  "name": "request_status",
                  "description": "Status of request for the order",
                  "type": "string",
                  "example": "\"submitted\""
                },
                "status": {
                  "name": "status",
                  "description": "Tracking order status",
                  "type": "string",
                  "example": "\"open\""
                }
              },
              "example": {
                "fulfillment_order_merchant_request": {
                  "message": "\"cancel order\""
                },
                "id": "\"21057401932826316666967110_4005740193290131085320\"",
                "request_status": "\"submitted\"",
                "status": "\"open\""
              }
            }
          },
          "example": {
            "fulfillment_order": {
              "fulfillment_order_merchant_request": {
                "message": "\"cancel order\""
              },
              "id": "\"21057401932826316666967110_4005740193290131085320\"",
              "request_status": "\"submitted\"",
              "status": "\"open\""
            }
          }
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "description": "After receiving a webhook notification from SHOPLINE, you must respond with the following format: \n\n``` HTTP/1.1 200 OK ```\n\nFor more information about how to subscribe to webhooks and webhook response rules, refer to [Webhook overview](https://developer.shopline.com/docs/apps/api-instructions-for-use/webhooks/overview.md)."
    }
  },
  "info": {
    "title": "Cancellation request for fulfillment order",
    "version": "v20270301"
  }
}
```