BigCommerce · Schema

RefundID_Get

E-CommerceRetailCatalogOrdersCheckoutPaymentsSaaS

Properties

Name Type Description
data object
meta object
View JSON Schema on GitHub

JSON Schema

bigcommerce-refundid-get-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/RefundID_Get",
  "title": "RefundID_Get",
  "type": "object",
  "x-examples": {
    "Example": {
      "data": {
        "id": 12,
        "order_id": 180,
        "user_id": 0,
        "created": "2022-06-16T16:44:15+00:00",
        "reason": "Customer requires a refund.",
        "total_amount": 50,
        "total_tax": 5,
        "uses_merchant_override_values": false,
        "payments": [
          {
            "id": 13,
            "provider_id": "storecredit",
            "amount": 50,
            "offline": true,
            "is_declined": false,
            "declined_message": ""
          }
        ],
        "items": [
          {
            "item_type": "PRODUCT",
            "item_id": 87,
            "quantity": 1,
            "requested_amount": null
          }
        ]
      },
      "meta": {}
    }
  },
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "id": {
          "type": "integer",
          "description": "Refund ID for the returned refund.\n"
        },
        "order_id": {
          "type": "integer",
          "description": "Order ID associated with the refund."
        },
        "user_id": {
          "type": "integer",
          "description": "Reference to the user ID who created the refund. This is automatically populated by BigCommerce.\n"
        },
        "created": {
          "type": "string",
          "description": "Timestamp of when the refund was created.\n",
          "format": "date-time"
        },
        "reason": {
          "type": "string",
          "description": "Reason for refund.\n"
        },
        "total_amount": {
          "type": "number",
          "description": "A non-negative 2 decimal place rounded value that represents the amount that can be refunded with the correct payment provider(s).\n",
          "example": 109.11
        },
        "total_tax": {
          "type": "number",
          "description": "Total tax amount refunded back to the shopper. This can be a negative amount indicating we have collected tax by refunding less to the customer.\n"
        },
        "uses_merchant_override_values": {
          "type": "boolean",
          "description": "Whether refund amount and tax are provided explicitly by merchant override.\n"
        },
        "payments": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "id": {
                "type": "integer",
                "description": "Reference to refund payment ID.\n"
              },
              "provider_id": {
                "type": "string",
                "description": "Reference to payment provider.\nexample: storecredit\n"
              },
              "amount": {
                "type": "number",
                "description": "A non-negative two decimal place rounded value represents the amount that can be charged/refunded with payment providers.\n",
                "example": 109.11
              },
              "offline": {
                "type": "boolean",
                "description": "Indicates whether the payment was offline.\n"
              },
              "is_declined": {
                "type": "boolean",
                "description": "Indicates if this payment has been declined by the payment provider.\n"
              },
              "declined_message": {
                "type": "string",
                "description": "Message indicates why the payment was declined.\n"
              }
            }
          }
        },
        "items": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "item_type": {
                "type": "string",
                "description": "Type of item that was refunded.\n",
                "enum": [
                  "PRODUCT",
                  "GIFT_WRAPPING",
                  "SHIPPING",
                  "HANDLING",
                  "ORDER"
                ]
              },
              "item_id": {
                "type": "integer",
                "description": "`order_product.id` corresponding to the item_types of PRODUCT, GIFT_WRAPPING. `order_address.id` corresponding to the item_types of SHIPPING, HANDLING. `order.id` corresponding to the item_type of ORDER.\n"
              },
              "quantity": {
                "type": "integer",
                "description": "Quantity of item refunded. Note: this will only be populated for item_type PRODUCT.\n"
              },
              "requested_amount": {
                "type": "string",
                "description": "A non-negative two decimal place rounded value that represents the amount that can be refunded with the payment provider(s).\n",
                "example": "109.11",
                "nullable": true
              },
              "reason": {
                "type": "string",
                "description": "Reason for refunding an item.\n"
              }
            }
          }
        }
      }
    },
    "meta": {
      "$ref": "#/components/schemas/metaEmpty_Full"
    }
  }
}