Jump to

• Request
• Response

getShopperSettings

get

/ccstore/v1/merchant/shopperSettings

Get global and site level shopper settings

Request

Supported Media Types

• application/json

Header Parameters

• x-ccsite(optional): string
  the site id to retrieve site specific settings

Back to Top

Response

Supported Media Types

• application/json

200 Response

Following model is returned when operation succeeds.

Body ()

Root Schema : getShopperSettings_response

Type: object

Show Source

• enableProfileRegistrationEmailCheck(optional): boolean
  true if profile Registration email check is enabled.
• guestCheckoutEnabled(optional): boolean
  Applies the authorization for anonymous shoppers to sign-in to complete checkout.
• passwordExpirationEnabled(optional): boolean
  Applies the password expiration constraint.
• passwordExpirationLength(optional): integer
  number of days after which the current password of the shopper will automatically expire.
• passwordPolicies(optional): object passwordPolicies
  Constraints that must be statisfied by password.
• selfRegistrationEnabled(optional): boolean
  Set the flag to true if Self Registration is required.
• sessionTimeoutEnabled(optional): boolean
  Applies the session timeout length constraint.
• sessionTimeoutLength(optional): integer
  Timeout duration for all shopper sessions.
• softLoginEnabled(optional): boolean
  true if SoftLogin is enabled.

{
    "properties":{
        "sessionTimeoutEnabled":{
            "description":"Applies the session timeout length constraint.",
            "type":"boolean"
        },
        "guestCheckoutEnabled":{
            "description":"Applies the authorization for anonymous shoppers to sign-in to complete checkout.",
            "type":"boolean"
        },
        "selfRegistrationEnabled":{
            "description":"Set the flag to true if Self Registration is required.",
            "type":"boolean"
        },
        "passwordExpirationEnabled":{
            "description":"Applies the password expiration constraint.",
            "type":"boolean"
        },
        "sessionTimeoutLength":{
            "description":"Timeout duration for all shopper sessions.",
            "type":"integer"
        },
        "softLoginEnabled":{
            "description":"true if SoftLogin is enabled.",
            "type":"boolean"
        },
        "enableProfileRegistrationEmailCheck":{
            "description":"true if profile Registration email check is enabled.",
            "type":"boolean"
        },
        "passwordPolicies":{
            "description":"Constraints that must be statisfied by password.",
            "type":"object",
            "properties":{
                "useNumber":{
                    "description":"Password must include a number.",
                    "type":"boolean"
                },
                "allowedSymbols":{
                    "description":"List of symboles allowed in Password.",
                    "type":"string"
                },
                "numberOfPreviousPasswords":{
                    "description":"password should not have been used as previous N passwords for the given shopper user.",
                    "type":"integer"
                },
                "cannotUseUsername":{
                    "description":"Password must not be the same as their Username.",
                    "type":"boolean"
                },
                "useMinPasswordLength":{
                    "description":"Applies the minimum password length constraint.",
                    "type":"boolean"
                },
                "minPasswordLength":{
                    "description":"Minimum length of the password.",
                    "type":"integer"
                },
                "useMixedCase":{
                    "description":"Applies the usage of capital letters in user password..",
                    "type":"boolean"
                },
                "blockCommonPasswords":{
                    "description":"Block the Use of Commonly Chosen Passwords and Weak Passphrases.",
                    "type":"boolean"
                },
                "cannotUsePreviousPasswords":{
                    "description":"Applies the previous password usage constraint.",
                    "type":"boolean"
                },
                "useSymbol":{
                    "description":"Applies the usage of symbol in user password.",
                    "type":"boolean"
                }
            }
        },
        "passwordExpirationLength":{
            "description":"number of days after which the current password of the shopper will automatically expire.",
            "type":"integer"
        }
    }
}

Nested Schema : passwordPolicies

Type: object

Constraints that must be statisfied by password.

Show Source

• allowedSymbols(optional): string
  List of symboles allowed in Password.
• blockCommonPasswords(optional): boolean
  Block the Use of Commonly Chosen Passwords and Weak Passphrases.
• cannotUsePreviousPasswords(optional): boolean
  Applies the previous password usage constraint.
• cannotUseUsername(optional): boolean
  Password must not be the same as their Username.
• minPasswordLength(optional): integer
  Minimum length of the password.
• numberOfPreviousPasswords(optional): integer
  password should not have been used as previous N passwords for the given shopper user.
• useMinPasswordLength(optional): boolean
  Applies the minimum password length constraint.
• useMixedCase(optional): boolean
  Applies the usage of capital letters in user password..
• useNumber(optional): boolean
  Password must include a number.
• useSymbol(optional): boolean
  Applies the usage of symbol in user password.

{
    "description":"Constraints that must be statisfied by password.",
    "type":"object",
    "properties":{
        "useNumber":{
            "description":"Password must include a number.",
            "type":"boolean"
        },
        "allowedSymbols":{
            "description":"List of symboles allowed in Password.",
            "type":"string"
        },
        "numberOfPreviousPasswords":{
            "description":"password should not have been used as previous N passwords for the given shopper user.",
            "type":"integer"
        },
        "cannotUseUsername":{
            "description":"Password must not be the same as their Username.",
            "type":"boolean"
        },
        "useMinPasswordLength":{
            "description":"Applies the minimum password length constraint.",
            "type":"boolean"
        },
        "minPasswordLength":{
            "description":"Minimum length of the password.",
            "type":"integer"
        },
        "useMixedCase":{
            "description":"Applies the usage of capital letters in user password..",
            "type":"boolean"
        },
        "blockCommonPasswords":{
            "description":"Block the Use of Commonly Chosen Passwords and Weak Passphrases.",
            "type":"boolean"
        },
        "cannotUsePreviousPasswords":{
            "description":"Applies the previous password usage constraint.",
            "type":"boolean"
        },
        "useSymbol":{
            "description":"Applies the usage of symbol in user password.",
            "type":"boolean"
        }
    }
}

Example Response (application/json)

{
    "sessionTimeoutEnabled":true,
    "guestCheckoutEnabled":true,
    "selfRegistrationEnabled":false,
    "passwordExpirationEnabled":false,
    "sessionTimeoutLength":15,
    "softLoginEnabled":true,
    "enableProfileRegistrationEmailCheck":false,
    "passwordPolicies":{
        "useNumber":true,
        "allowedSymbols":"~!@#$%^&*()_-+={}[]|:;<>,./?",
        "numberOfPreviousPasswords":3,
        "cannotUseUsername":true,
        "useMinPasswordLength":true,
        "minPasswordLength":8,
        "useMixedCase":true,
        "blockCommonPasswords":false,
        "cannotUsePreviousPasswords":false,
        "useSymbol":true
    },
    "passwordExpirationLength":90
}

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