Etsy · JSON Structure

Open Api V3 Shop Refund Structure

The refund record for a receipt.

Type: object Properties: 5
MarketplaceEcommerceHandmadeListingsOrdersPaymentsReviewsShippingTaxonomyOAuth2

ShopRefund is a JSON Structure definition published by Etsy, describing 5 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

amount created_timestamp reason note_from_issuer status

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/etsy/refs/heads/main/json-structure/open-api-v3-shop-refund-structure.json",
  "name": "ShopRefund",
  "description": "The refund record for a receipt.",
  "type": "object",
  "properties": {
    "amount": {
      "description": "A number equal to the refund total.",
      "oneOf": [
        {
          "$ref": "#/components/schemas/Money"
        }
      ],
      "example": "example"
    },
    "created_timestamp": {
      "type": "int32",
      "description": "The date & time of the refund, in epoch seconds.",
      "minimum": 946684800,
      "example": 1758153645
    },
    "reason": {
      "type": "string",
      "description": "The reason string given for the refund.",
      "nullable": true,
      "example": "example string"
    },
    "note_from_issuer": {
      "type": "string",
      "description": "The note string created by the refund issuer.",
      "nullable": true,
      "example": "Thanks for your order! Shipping out tomorrow."
    },
    "status": {
      "type": "string",
      "description": "The status indication string for the refund.",
      "nullable": true,
      "example": "example string"
    }
  }
}