{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/bigcommerce/main/json-schema/bigcommerce-gift-certificate-put-schema.json",
  "title": "giftCertificate_Put",
  "x-generated": "2026-10-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/bigcommerce-gift-certificates-api-openapi.yml#/components/schemas/giftCertificate_Put",
  "allOf": [
    {
      "$ref": "#/$defs/giftCertificate_Base"
    },
    {
      "type": "object",
      "properties": {
        "balance": {
          "type": "string",
          "description": "The remaining value of the gift certificate. If not set, will default to the amount."
        },
        "purchase_date": {
          "type": "string",
          "description": "Date the gift certificate was purchased. If not assigned, this will be set to today’s date. Enter date in RFC-2822 format."
        },
        "expiry_date": {
          "type": "string",
          "description": "Date on which the gift certificate is set to expire."
        },
        "customer_id": {
          "type": "integer",
          "description": "The ID of the customer placing the order."
        },
        "template": {
          "type": "string",
          "description": "The email theme to use in the message sent to the recipient.",
          "enum": [
            "birthday.html",
            "boy.html",
            "girl.html",
            "celebration.html",
            "christmas.html",
            "general.html"
          ]
        },
        "message": {
          "type": "string",
          "description": "Text that will be sent to the recipient, such as “Congratulations.”"
        },
        "code": {
          "maxLength": 255,
          "type": "string",
          "description": "A unique string that a customer can input to redeem a gift certificate. Values greater than 20 characters will be trimmed down to the first 20 characters and returned in the response.\nIf this field is not set, a value will be autogenerated."
        },
        "status": {
          "type": "string",
          "enum": [
            "active",
            "pending",
            "expired",
            "disabled"
          ]
        },
        "currency_code": {
          "type": "string",
          "description": "A currency code, following the ISO 4217 standard. The currency has to exist in the store first.\n\nGift Certificates can only be used if the transactional currency of the cart is the same as the one defined in the gift certificate. If this value is not provided, the gift certificate is created using the store's default transactional currency."
        }
      }
    }
  ],
  "x-internal": false,
  "$defs": {
    "giftCertificate_Base": {
      "title": "giftCertificate_Base",
      "required": [
        "amount",
        "from_email",
        "from_name",
        "to_email",
        "to_name"
      ],
      "type": "object",
      "properties": {
        "to_name": {
          "type": "string",
          "description": "Name of the recipient."
        },
        "to_email": {
          "type": "string",
          "description": "Email of the recipient."
        },
        "from_name": {
          "type": "string",
          "description": "Name of the customer who purchased the gift certificate."
        },
        "from_email": {
          "type": "string",
          "description": "Email of the customer who purchased the gift certificate."
        },
        "amount": {
          "type": "string",
          "description": "Value of the gift certificate."
        }
      },
      "x-internal": false
    }
  }
}