# Modify risk score blocklist rules Modifies risk score blocklist rules. Endpoint: PUT /risk-score-rules/blocklists Version: latest Security: SecretApiKey, JWT ## Request fields (application/json): - `permanentlyBlockList` (object,null) Items permanently blocklisted when TTL is equal to 0. - `permanentlyBlockList.address` (object) House number and ZIP code of the customer's address. - `permanentlyBlockList.address.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.bankAccount` (object) Bank account for the charge. - `permanentlyBlockList.bankAccount.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.bin` (object) Bank Identification Number (BIN) of the payment card for the charge. - `permanentlyBlockList.bin.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.country` (object) Country where the customer is making the purchase, and country of the payment card billing address. - `permanentlyBlockList.country.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.customerId` (object) Rebilly customerId of the customer making the purchase. - `permanentlyBlockList.customerId.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.email` (object) Email address of the customer making the purchase. - `permanentlyBlockList.email.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.emailDomain` (object) Email address domain of the customer making the purchase. - `permanentlyBlockList.emailDomain.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.fingerprint` (object) Fingerprint of the user's device. A device fingerprint is a unique token that is used to identify the user. The device fingerprint is generated based on device attributes, such as: hardware, software, IP address, language, browser, and more. - `permanentlyBlockList.fingerprint.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.ipAddress` (object) IP address of the customer making the purchase. - `permanentlyBlockList.ipAddress.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.paymentCard` (object) Payment card number being charged. - `permanentlyBlockList.paymentCard.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList` (object,null) Items temporarily blocklisted when TTL is greater than 0. - `temporaryBlockList.address` (object) House number and ZIP code of the customer's address. - `temporaryBlockList.address.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.address.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.bankAccount` (object) Bank account for the charge. - `temporaryBlockList.bankAccount.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.bankAccount.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.bin` (object) Bank Identification Number (BIN) of the payment card for the charge. - `temporaryBlockList.bin.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.bin.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.country` (object) Country where the customer is making the purchase, and country of the payment card billing address. - `temporaryBlockList.country.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.country.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.customerId` (object) Rebilly customerId of the customer making the purchase. - `temporaryBlockList.customerId.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.customerId.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.email` (object) Email address of the customer making the purchase. - `temporaryBlockList.email.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.email.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.emailDomain` (object) Email address domain of the customer making the purchase. - `temporaryBlockList.emailDomain.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.emailDomain.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.fingerprint` (object) Fingerprint of the user's device. A device fingerprint is a unique token that is used to identify the user. The device fingerprint is generated based on device attributes, such as: hardware, software, IP address, language, browser, and more. - `temporaryBlockList.fingerprint.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.fingerprint.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.ipAddress` (object) IP address of the customer making the purchase. - `temporaryBlockList.ipAddress.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.ipAddress.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.paymentCard` (object) Payment card number for the charge. - `temporaryBlockList.paymentCard.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.paymentCard.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. ## Response 200 fields (application/json): - `permanentlyBlockList` (object,null) Items permanently blocklisted when TTL is equal to 0. - `permanentlyBlockList.address` (object) House number and ZIP code of the customer's address. - `permanentlyBlockList.address.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.bankAccount` (object) Bank account for the charge. - `permanentlyBlockList.bankAccount.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.bin` (object) Bank Identification Number (BIN) of the payment card for the charge. - `permanentlyBlockList.bin.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.country` (object) Country where the customer is making the purchase, and country of the payment card billing address. - `permanentlyBlockList.country.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.customerId` (object) Rebilly customerId of the customer making the purchase. - `permanentlyBlockList.customerId.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.email` (object) Email address of the customer making the purchase. - `permanentlyBlockList.email.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.emailDomain` (object) Email address domain of the customer making the purchase. - `permanentlyBlockList.emailDomain.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.fingerprint` (object) Fingerprint of the user's device. A device fingerprint is a unique token that is used to identify the user. The device fingerprint is generated based on device attributes, such as: hardware, software, IP address, language, browser, and more. - `permanentlyBlockList.fingerprint.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.ipAddress` (object) IP address of the customer making the purchase. - `permanentlyBlockList.ipAddress.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.paymentCard` (object) Payment card number being charged. - `permanentlyBlockList.paymentCard.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList` (object,null) Items temporarily blocklisted when TTL is greater than 0. - `temporaryBlockList.address` (object) House number and ZIP code of the customer's address. - `temporaryBlockList.address.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.address.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.bankAccount` (object) Bank account for the charge. - `temporaryBlockList.bankAccount.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.bankAccount.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.bin` (object) Bank Identification Number (BIN) of the payment card for the charge. - `temporaryBlockList.bin.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.bin.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.country` (object) Country where the customer is making the purchase, and country of the payment card billing address. - `temporaryBlockList.country.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.country.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.customerId` (object) Rebilly customerId of the customer making the purchase. - `temporaryBlockList.customerId.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.customerId.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.email` (object) Email address of the customer making the purchase. - `temporaryBlockList.email.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.email.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.emailDomain` (object) Email address domain of the customer making the purchase. - `temporaryBlockList.emailDomain.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.emailDomain.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.fingerprint` (object) Fingerprint of the user's device. A device fingerprint is a unique token that is used to identify the user. The device fingerprint is generated based on device attributes, such as: hardware, software, IP address, language, browser, and more. - `temporaryBlockList.fingerprint.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.fingerprint.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.ipAddress` (object) IP address of the customer making the purchase. - `temporaryBlockList.ipAddress.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.ipAddress.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.paymentCard` (object) Payment card number for the charge. - `temporaryBlockList.paymentCard.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.paymentCard.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. ## Response 201 fields (application/json): - `permanentlyBlockList` (object,null) Items permanently blocklisted when TTL is equal to 0. - `permanentlyBlockList.address` (object) House number and ZIP code of the customer's address. - `permanentlyBlockList.address.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.bankAccount` (object) Bank account for the charge. - `permanentlyBlockList.bankAccount.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.bin` (object) Bank Identification Number (BIN) of the payment card for the charge. - `permanentlyBlockList.bin.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.country` (object) Country where the customer is making the purchase, and country of the payment card billing address. - `permanentlyBlockList.country.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.customerId` (object) Rebilly customerId of the customer making the purchase. - `permanentlyBlockList.customerId.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.email` (object) Email address of the customer making the purchase. - `permanentlyBlockList.email.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.emailDomain` (object) Email address domain of the customer making the purchase. - `permanentlyBlockList.emailDomain.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.fingerprint` (object) Fingerprint of the user's device. A device fingerprint is a unique token that is used to identify the user. The device fingerprint is generated based on device attributes, such as: hardware, software, IP address, language, browser, and more. - `permanentlyBlockList.fingerprint.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.ipAddress` (object) IP address of the customer making the purchase. - `permanentlyBlockList.ipAddress.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `permanentlyBlockList.paymentCard` (object) Payment card number being charged. - `permanentlyBlockList.paymentCard.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList` (object,null) Items temporarily blocklisted when TTL is greater than 0. - `temporaryBlockList.address` (object) House number and ZIP code of the customer's address. - `temporaryBlockList.address.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.address.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.bankAccount` (object) Bank account for the charge. - `temporaryBlockList.bankAccount.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.bankAccount.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.bin` (object) Bank Identification Number (BIN) of the payment card for the charge. - `temporaryBlockList.bin.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.bin.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.country` (object) Country where the customer is making the purchase, and country of the payment card billing address. - `temporaryBlockList.country.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.country.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.customerId` (object) Rebilly customerId of the customer making the purchase. - `temporaryBlockList.customerId.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.customerId.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.email` (object) Email address of the customer making the purchase. - `temporaryBlockList.email.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.email.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.emailDomain` (object) Email address domain of the customer making the purchase. - `temporaryBlockList.emailDomain.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.emailDomain.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.fingerprint` (object) Fingerprint of the user's device. A device fingerprint is a unique token that is used to identify the user. The device fingerprint is generated based on device attributes, such as: hardware, software, IP address, language, browser, and more. - `temporaryBlockList.fingerprint.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.fingerprint.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.ipAddress` (object) IP address of the customer making the purchase. - `temporaryBlockList.ipAddress.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.ipAddress.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. - `temporaryBlockList.paymentCard` (object) Payment card number for the charge. - `temporaryBlockList.paymentCard.riskScoreThreshold` (integer, required) Pass and fail threshold for the blocklist. - `temporaryBlockList.paymentCard.ttl` (integer, required) Amount of seconds a blocklist exists before it expires. This value must be greater than 0. ## Response 401 fields (application/json): - `status` (integer) HTTP status code. - `type` (string) Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference. It should provide human-readable documentation for the problem type. When this member is not present, its value is assumed to be "about:blank". - `title` (string) Short, human-readable summary of the problem type. Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem. - `detail` (string) Human-readable explanation that is specific to this occurrence of the problem. - `instance` (string) URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. ## Response 403 fields (application/json): - `status` (integer) HTTP status code. - `type` (string) Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference. It should provide human-readable documentation for the problem type. When this member is not present, its value is assumed to be "about:blank". - `title` (string) Short, human-readable summary of the problem type. Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem. - `detail` (string) Human-readable explanation that is specific to this occurrence of the problem. - `instance` (string) URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. ## Response 422 fields (application/json): - `status` (integer) HTTP status code. - `type` (string) Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference. It should provide human-readable documentation for the problem type. When this member is not present, its value is assumed to be "about:blank". - `title` (string) Short, human-readable summary of the problem type. Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem. - `detail` (string) Human-readable explanation that is specific to this occurrence of the problem. - `instance` (string) URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. - `invalidFields` (array) Invalid field details. - `invalidFields.field` (string) Name of the field. Dot notation is used for nested object field names. - `invalidFields.message` (string) Message field. ## Response 429 fields (application/json): - `type` (string) Problem type in the form of a [URI](https://tools.ietf.org/html/rfc3986) reference. It should provide human-readable documentation for the problem type. When this member is not present, its value is assumed to be "about:blank". Example: "about:blank" - `title` (string) Short, human-readable summary of the problem type. Other than for the purposes of localization, this should not change from occurrence to occurrence of the problem. Example: "Rate Limit Exceeded" - `status` (integer) HTTP status code. - `detail` (string) Human-readable explanation that is specific to this occurrence of the problem. Example: "A request cannot be executed because the user has sent too many requests within a certain period of time" - `instance` (string) URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.