Jump to

• Request
• Response

getReturnStates

get

/ccagent/v1/merchant/returnStates

Get Return States. Lists the Order States when Return action will be allowed against orders

Request

There are no request parameters for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Following model is returned when operation succeeds.

Body ()

Root Schema : getReturnStates_response

Type: object

Show Source

• items(optional): array items
  The list of all states of a Return Request.

{
    "properties":{
        "items":{
            "description":"The list of all states of a Return Request.",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "displayKey":{
                        "description":"Display Key of the state of a Return Request",
                        "type":"string"
                    },
                    "displayName":{
                        "description":"Display Name of the state of a Return Request",
                        "type":"string"
                    }
                }
            }
        }
    }
}

Nested Schema : items

Type: array

The list of all states of a Return Request.

Show Source

• Array of: object items

{
    "description":"The list of all states of a Return Request.",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "displayKey":{
                "description":"Display Key of the state of a Return Request",
                "type":"string"
            },
            "displayName":{
                "description":"Display Name of the state of a Return Request",
                "type":"string"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

• displayKey(optional): string
  Display Key of the state of a Return Request
• displayName(optional): string
  Display Name of the state of a Return Request

{
    "type":"object",
    "properties":{
        "displayKey":{
            "description":"Display Key of the state of a Return Request",
            "type":"string"
        },
        "displayName":{
            "description":"Display Name of the state of a Return Request",
            "type":"string"
        }
    }
}

Example Response (application/json)

[
    {
        "displayKey":"PENDING_CUSTOMER_ACTION",
        "displayName":"Approved"
    },
    {
        "displayKey":"COMPLETE",
        "displayName":"Complete"
    },
    {
        "displayKey":"FULL_RETURN",
        "displayName":"Full return"
    },
    {
        "displayKey":"PARTIAL_RETURN",
        "displayName":"Partial return"
    },
    {
        "displayKey":"PENDING_REFUND",
        "displayName":"Pending Refund"
    }
]

Default Response

The error response

Body ()

Root Schema : errorModel

Type: object

Show Source

• devMessage(optional): string
  An optional non-localized message containing technical information for developers
• errorCode(optional): string
  The numerical code identifying the error
• errors(optional): array errors
  An optional list of errors if multiple errors were encountered
• message(optional): string
  The localized message describing the error
• moreInfo(optional): string
  An optional non-localized message with more information
• o:errorPath(optional): string
  An optional machine readable description of where the error occurred
• status(optional): string
  The HTTP status code
• type(optional): string
  The URI to the HTTP state code definition

{
    "type":"object",
    "properties":{
        "errorCode":{
            "description":"The numerical code identifying the error",
            "type":"string"
        },
        "message":{
            "description":"The localized message describing the error",
            "type":"string"
        },
        "type":{
            "description":"The URI to the HTTP state code definition",
            "type":"string"
        },
        "devMessage":{
            "description":"An optional non-localized message containing technical information for developers",
            "type":"string"
        },
        "moreInfo":{
            "description":"An optional non-localized message with more information",
            "type":"string"
        },
        "o:errorPath":{
            "description":"An optional machine readable description of where the error occurred",
            "type":"string"
        },
        "errors":{
            "description":"An optional list of errors if multiple errors were encountered",
            "type":"array",
            "items":{
                "type":"object",
                "properties":{
                    "errorCode":{
                        "description":"The numerical code identifying the error",
                        "type":"string"
                    },
                    "message":{
                        "description":"The localized message describing the error",
                        "type":"string"
                    },
                    "devMessage":{
                        "description":"An optional non-localized message containing technical information for developers",
                        "type":"string"
                    },
                    "moreInfo":{
                        "description":"An optional non-localized message with more information",
                        "type":"string"
                    },
                    "o:errorPath":{
                        "description":"An optional machine readable description of where the error occurred",
                        "type":"string"
                    },
                    "status":{
                        "description":"The HTTP status code",
                        "type":"string"
                    }
                }
            }
        },
        "status":{
            "description":"The HTTP status code",
            "type":"string"
        }
    }
}

Nested Schema : errors

Type: array

An optional list of errors if multiple errors were encountered

Show Source

• Array of: object items

{
    "description":"An optional list of errors if multiple errors were encountered",
    "type":"array",
    "items":{
        "type":"object",
        "properties":{
            "errorCode":{
                "description":"The numerical code identifying the error",
                "type":"string"
            },
            "message":{
                "description":"The localized message describing the error",
                "type":"string"
            },
            "devMessage":{
                "description":"An optional non-localized message containing technical information for developers",
                "type":"string"
            },
            "moreInfo":{
                "description":"An optional non-localized message with more information",
                "type":"string"
            },
            "o:errorPath":{
                "description":"An optional machine readable description of where the error occurred",
                "type":"string"
            },
            "status":{
                "description":"The HTTP status code",
                "type":"string"
            }
        }
    }
}

Nested Schema : items

Type: object

Show Source

• devMessage(optional): string
  An optional non-localized message containing technical information for developers
• errorCode(optional): string
  The numerical code identifying the error
• message(optional): string
  The localized message describing the error
• moreInfo(optional): string
  An optional non-localized message with more information
• o:errorPath(optional): string
  An optional machine readable description of where the error occurred
• status(optional): string
  The HTTP status code

{
    "type":"object",
    "properties":{
        "errorCode":{
            "description":"The numerical code identifying the error",
            "type":"string"
        },
        "message":{
            "description":"The localized message describing the error",
            "type":"string"
        },
        "devMessage":{
            "description":"An optional non-localized message containing technical information for developers",
            "type":"string"
        },
        "moreInfo":{
            "description":"An optional non-localized message with more information",
            "type":"string"
        },
        "o:errorPath":{
            "description":"An optional machine readable description of where the error occurred",
            "type":"string"
        },
        "status":{
            "description":"The HTTP status code",
            "type":"string"
        }
    }
}

Back to Top