PostEcommerceRefundRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/lynx/main/json-schema/lynx-post-ecommerce-refund-request-schema.json",
  "title": "PostEcommerceRefundRequest",
  "x-generated": "2026-10-14",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/lynx-commerce-order-api-openapi.yml#/components/schemas/PostEcommerceRefundRequest",
  "type": "object",
  "properties": {
    "data": {
      "$ref": "#/$defs/EcommerceRefundRequestDto"
    },
    "idempotency": {
      "$ref": "#/$defs/Idempotency",
      "description": "Unique identifier that represents the operation"
    }
  },
  "required": [
    "data",
    "idempotency"
  ],
  "$defs": {
    "BaseCartItemDto": {
      "type": "object",
      "properties": {
        "sku": {
          "type": "string",
          "description": "Stock Keeping Unit"
        },
        "quantity": {
          "type": "integer",
          "format": "int32",
          "description": "The quantity for this item."
        }
      }
    },
    "BaseCommerceOrderDto": {
      "type": "object",
      "properties": {
        "orderNumber": {
          "type": "string",
          "description": "A unique order identifier created when an order is placed"
        }
      },
      "required": [
        "orderNumber"
      ]
    },
    "BaseMember": {
      "type": "object",
      "properties": {
        "clientMemberId": {
          "type": "string",
          "description": "Unique client-side identifier for the member"
        }
      },
      "required": [
        "clientMemberId"
      ]
    },
    "ClientOrgDto": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "The name of the client organization"
        }
      },
      "required": [
        "name"
      ]
    },
    "EcommerceRefundRequestDto": {
      "type": "object",
      "properties": {
        "clientOrg": {
          "$ref": "#/$defs/ClientOrgDto"
        },
        "member": {
          "$ref": "#/$defs/BaseMember"
        },
        "memberCommerceOrder": {
          "$ref": "#/$defs/BaseCommerceOrderDto"
        },
        "memberCommerceOrderLines": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/BaseCartItemDto"
          }
        },
        "refundReason": {
          "type": "string",
          "description": "Reason for refunding an item",
          "enum": [
            "Never Received",
            "Damaged Good",
            "Wrong Item",
            "Other"
          ]
        }
      },
      "required": [
        "refundReason"
      ]
    },
    "Idempotency": {
      "type": "object",
      "properties": {
        "idempotencyKey": {
          "type": "string",
          "description": "Unique identifier that represents the operation"
        }
      }
    }
  }
}