{ "$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" } } }