{ "opencollection": "1.0.0", "info": { "name": "API Reference Accounting Codes Refunds API", "version": "2023-12-15" }, "items": [ { "info": { "name": "Refunds", "type": "folder" }, "items": [ { "info": { "name": "List refunds", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/v1/refunds", "headers": [ { "name": "Accept-Encoding", "value": "" }, { "name": "Content-Encoding", "value": "" }, { "name": "Authorization", "value": "" }, { "name": "Zuora-Track-Id", "value": "" }, { "name": "Zuora-Entity-Ids", "value": "" }, { "name": "Zuora-Org-Ids", "value": "" } ], "params": [ { "name": "page", "value": "", "type": "query", "description": "The index number of the page that you want to retrieve. This parameter is dependent on `pageSize`. You must set `pageSize` before specifying `page`. For example, if you set `pageSize` to `20` and `page` to `2`, the 21st to 40th records are returned in the response.\n" }, { "name": "pageSize", "value": "", "type": "query", "description": "The number of records returned per page in the response.\n" }, { "name": "accountId", "value": "", "type": "query", "description": "This parameter filters the response based on the `accountId` field.\n" }, { "name": "amount", "value": "", "type": "query", "description": "This parameter filters the response based on the `amount` field.\n" }, { "name": "createdById", "value": "", "type": "query", "description": "This parameter filters the response based on the `createdById` field.\n" }, { "name": "createdDate", "value": "", "type": "query", "description": "This parameter filters the response based on the `createdDate` field.\n" }, { "name": "methodType", "value": "", "type": "query", "description": "This parameter filters the response based on the `methodType` field.\n" }, { "name": "number", "value": "", "type": "query", "description": "This parameter filters the response based on the `number` field.\n" }, { "name": "paymentId", "value": "", "type": "query", "description": "This parameter filters the response based on the `paymentId` field.\n" }, { "name": "refundDate", "value": "", "type": "query", "description": "This parameter filters the response based on the `refundDate` field.\n" }, { "name": "status", "value": "", "type": "query", "description": "This parameter filters the response based on the `status` field.\n" }, { "name": "type", "value": "", "type": "query", "description": "This parameter filters the response based on the `type` field.\n" }, { "name": "updatedById", "value": "", "type": "query", "description": "This parameter filters the response based on the `updatedById` field.\n" }, { "name": "updatedDate", "value": "", "type": "query", "description": "This parameter filters the response based on the `updatedDate` field.\n" }, { "name": "sort", "value": "", "type": "query", "description": "This parameter restricts the order of the data returned in the response. You can use this parameter to supply a dimension you want to sort on.\n\nA sortable field uses the following form: \n\n*operator* *field_name*\n\nYou can use at most two sortable fields in one URL path. Use a comma to separate sortable fields. For example: *operator* *field_name*, *operator* *field_name* \n\n*operator* is used to mark the order of sequencing. The operator is optional. If you only specify the sortable field without any operator, the response data is sorted in descending order by this field.\n\n - The `-` operator indicates an ascending order.\n - The `+` operator indicates a descending order.\n\nBy default, the response data is displayed in descending order by refund number.\n\n*field_name* indicates the name of a sortable field. The supported sortable fields of this operation are as below:\n\n - number\n - accountId\n - amount\n - refundDate\n - paymentId\n - createdDate\n - createdById\n - updatedDate\n - updatedById\n \nExamples:\n\n- /v1/refunds?sort=+number\n\n- /v1/refunds?status=Processed&sort=-number,+amount\n" } ] }, "docs": "**Note:** This operation is only available if you have [Invoice Settlement](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/Invoice_Settlement) enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://knowledgecenter.zuora.com/Billin" }, { "info": { "name": "Update a refund", "type": "http" }, "http": { "method": "PUT", "url": "{{baseUrl}}/v1/refunds/:refundId", "headers": [ { "name": "Accept-Encoding", "value": "" }, { "name": "Content-Encoding", "value": "" }, { "name": "Authorization", "value": "" }, { "name": "Zuora-Track-Id", "value": "" }, { "name": "Zuora-Entity-Ids", "value": "" }, { "name": "Zuora-Org-Ids", "value": "" } ], "params": [ { "name": "refundId", "value": "", "type": "path", "description": "The unique ID of a refund. For example, 4028905f5a87c0ff015a889e590e00c9.\n" } ] }, "docs": "**Note:** This operation is only available if you have [Invoice Settlement](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/Invoice_Settlement) enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://knowledgecenter.zuora.com/Billin" }, { "info": { "name": "Retrieve a refund", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/v1/refunds/:refundKey", "headers": [ { "name": "Accept-Encoding", "value": "" }, { "name": "Content-Encoding", "value": "" }, { "name": "Authorization", "value": "" }, { "name": "Zuora-Track-Id", "value": "" }, { "name": "Zuora-Entity-Ids", "value": "" }, { "name": "Zuora-Org-Ids", "value": "" } ], "params": [ { "name": "refundKey", "value": "", "type": "path", "description": "The unique ID of a refund or the refund number. For example, 4028905f5a87c0ff015a889e590e00c9.\n" } ] }, "docs": "**Note:** This operation is only available if you have [Invoice Settlement](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/Invoice_Settlement) enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://knowledgecenter.zuora.com/Billin" }, { "info": { "name": "Delete a refund", "type": "http" }, "http": { "method": "DELETE", "url": "{{baseUrl}}/v1/refunds/:refundKey", "headers": [ { "name": "Accept-Encoding", "value": "" }, { "name": "Content-Encoding", "value": "" }, { "name": "Authorization", "value": "" }, { "name": "Zuora-Track-Id", "value": "" }, { "name": "Zuora-Entity-Ids", "value": "" }, { "name": "Zuora-Org-Ids", "value": "" } ], "params": [ { "name": "refundKey", "value": "", "type": "path", "description": "The unique ID of a refund or the refund number. For example, 4028905f5a87c0ff015a889e590e00c9.\n" } ] }, "docs": "**Note:** This operation is only available if you have [Invoice Settlement](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/Invoice_Settlement) enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://knowledgecenter.zuora.com/Billin" }, { "info": { "name": "Cancel a refund", "type": "http" }, "http": { "method": "PUT", "url": "{{baseUrl}}/v1/refunds/:refundKey/cancel", "headers": [ { "name": "Accept-Encoding", "value": "" }, { "name": "Content-Encoding", "value": "" }, { "name": "Authorization", "value": "" }, { "name": "Zuora-Track-Id", "value": "" }, { "name": "Zuora-Entity-Ids", "value": "" }, { "name": "Zuora-Org-Ids", "value": "" } ], "params": [ { "name": "refundKey", "value": "", "type": "path", "description": "The unique ID of a refund or the refund number. For example, 4028905f5a87c0ff015a889e590e00c9. \n" } ] }, "docs": "**Note:** This operation is only available if you have [Invoice Settlement](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/Invoice_Settlement) enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://knowledgecenter.zuora.com/Billin" }, { "info": { "name": "List all parts of a refund", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/v1/refunds/:refundKey/parts", "headers": [ { "name": "Accept-Encoding", "value": "" }, { "name": "Content-Encoding", "value": "" }, { "name": "Authorization", "value": "" }, { "name": "Zuora-Track-Id", "value": "" }, { "name": "Zuora-Entity-Ids", "value": "" }, { "name": "Zuora-Org-Ids", "value": "" } ], "params": [ { "name": "refundKey", "value": "", "type": "path", "description": "The number or unique ID of a refund. For example, 4028905f5a87c0ff015a889e590e00c9.\n" } ] }, "docs": "**Note:** This operation is only available if you have [Invoice Settlement](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/Invoice_Settlement) enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://knowledgecenter.zuora.com/Billin" }, { "info": { "name": "Retrieve a refund part", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/v1/refunds/:refundKey/parts/:refundpartid", "headers": [ { "name": "Accept-Encoding", "value": "" }, { "name": "Content-Encoding", "value": "" }, { "name": "Authorization", "value": "" }, { "name": "Zuora-Track-Id", "value": "" }, { "name": "Zuora-Entity-Ids", "value": "" }, { "name": "Zuora-Org-Ids", "value": "" } ], "params": [ { "name": "refundpartid", "value": "", "type": "path", "description": "The unique ID of a specific refund part. You can get the refund part ID from the response of [List all parts of a refund](/api-references/api/operation/GET_RefundParts).\n" }, { "name": "refundKey", "value": "", "type": "path", "description": "The number or unique ID of a refund. For example, 4028905f5a87c0ff015a889e590e00c9.\n" } ] }, "docs": "**Note:** This operation is only available if you have [Invoice Settlement](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/Invoice_Settlement) enabled. The Invoice Settlement feature is generally available as of Zuora Billing Release 296 (March 2021). This feature includes Unapplied Payments, Credit and Debit Memo, and Invoice Item Settlement. If you want to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://knowledgecenter.zuora.com/Billin" }, { "info": { "name": "List all refund part items", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/v1/refunds/:refundKey/parts/:refundpartid/itemparts", "headers": [ { "name": "Accept-Encoding", "value": "" }, { "name": "Content-Encoding", "value": "" }, { "name": "Authorization", "value": "" }, { "name": "Zuora-Track-Id", "value": "" }, { "name": "Zuora-Entity-Ids", "value": "" }, { "name": "Zuora-Org-Ids", "value": "" } ], "params": [ { "name": "page", "value": "", "type": "query", "description": "The index number of the page that you want to retrieve. This parameter is dependent on `pageSize`. You must set `pageSize` before specifying `page`. For example, if you set `pageSize` to `20` and `page` to `2`, the 21st to 40th records are returned in the response.\n" }, { "name": "pageSize", "value": "", "type": "query", "description": "The number of records returned per page in the response.\n" }, { "name": "refundpartid", "value": "", "type": "path", "description": "The unique ID of a specific refund part. You can get the refund part ID from the response of [List all parts of a refund](/api-references/api/operation/GET_RefundParts).\n" }, { "name": "refundKey", "value": "", "type": "path", "description": "The number or unique ID of a refund. For example, 4028905f5a87c0ff015a889e590e00c9.\n" } ] }, "docs": "**Note:** This operation is only available if you have the [Invoice Item Settlement](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/Invoice_Settlement/C_Invoice_Item_Settlement) feature enabled. Invoice Item Settlement must be used together with other Invoice Settlement features (Unapplied Payments, and Credit and Debit memos). If you wish to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://knowledgecenter.zuora.com/Billing/Billing_and_P" }, { "info": { "name": "Retrieve a refund part item", "type": "http" }, "http": { "method": "GET", "url": "{{baseUrl}}/v1/refunds/:refundKey/parts/:refundpartid/itemparts/:itempartid", "headers": [ { "name": "Accept-Encoding", "value": "" }, { "name": "Content-Encoding", "value": "" }, { "name": "Authorization", "value": "" }, { "name": "Zuora-Track-Id", "value": "" }, { "name": "Zuora-Entity-Ids", "value": "" }, { "name": "Zuora-Org-Ids", "value": "" } ], "params": [ { "name": "itempartid", "value": "", "type": "path", "description": "The unique ID of a specific refund part item. You can get the refund part item ID from the response of [Get refund part items](/api-references/api/operation/GET_RefundItemParts).\n" }, { "name": "refundpartid", "value": "", "type": "path", "description": "The unique ID of a specific refund part. You can get the refund part ID from the response of [List all parts of a refund](/api-references/api/operation/GET_RefundParts).\n" }, { "name": "refundKey", "value": "", "type": "path", "description": "The number or unique ID of a refund. For example, 4028905f5a87c0ff015a889e590e00c9.\n" } ] }, "docs": "**Note:** This operation is only available if you have the [Invoice Item Settlement](https://knowledgecenter.zuora.com/Billing/Billing_and_Payments/Invoice_Settlement/C_Invoice_Item_Settlement) feature enabled. Invoice Item Settlement must be used together with other Invoice Settlement features (Unapplied Payments, and Credit and Debit memos). If you wish to enable Invoice Settlement, see [Invoice Settlement Enablement and Checklist Guide](https://knowledgecenter.zuora.com/Billing/Billing_and_P" } ] } ], "bundled": true }