Retrieves the details of an existing refund.
Requiresread_financeaccess scope.
The Get Refund API retrieves the details of a specific refund order using its unique identifier.
This API is especially useful for:
- Fetching the details of a specific refund order.
- Tracking the refund's status and processing timeline.
- Verifying the associated transaction and refund amounts.
Request Parameters
Public Request Parameters
Path Parameters
| Field | Type | Required | Example | Description |
|---|---|---|---|---|
id | string | Yes | 123456 | Unique identifier of the refund order. |
Response Explanation
Public Response Parameters
Successful Response
Field | Type | Example | Description |
|---|---|---|---|
| string |
| Status code for the request. |
| string |
| Additional message about the response. |
| object | Contains the refund order details. | |
| object | Refund order details. | |
| string |
| Unique identifier for the refund order. |
| string |
| Store ID associated with the refund. |
| string |
| ID of the transaction order associated with the refund. |
| string |
| Status of the refund: |
| string |
| Refund amount. |
| string |
| Currency used for the refund balance. |
| string |
| Original order amount prior to the refund. |
| string |
| Refund creation timestamp (ISO-8601 format). |
| string |
| Timestamp indicating when the refund was completed (ISO-8601 format). |
Error Response
Error responses in the API can be represented using two different fields: errors and error. Both fields provide details about issues encountered during request processing. Below is an explanation of the fields with their respective examples and descriptions.
| Field | Type | Description | Example |
|---|---|---|---|
code | string | The error code indicating the type of issue. | UnknownError |
message | string | A detailed message describing the error. | wrong cursor |
| Field | Type | Example | Description |
|---|---|---|---|
error | String | "store is not active" | Indicates an error encountered during the process |
Error Detail
| Status Code | Message | Possible Reason | Example Response |
|---|---|---|---|
| 400 | Bad Request | Invalid input format or request structure (e.g., missing required fields or incorrect data types). | Bad Request |
| Unauthorized | The request is missing valid authentication credentials or the credentials provided are invalid. | Unauthorized | |
| 500 | UnknownError | cursor is not invalid or empty. | Unknown error, please contact shoplazza technical support to resolve the issue. |
