BObonifiq
Customer

Remove the current tier from a customer

This endpoint removes the current tier association from the customer and moves them back to the base tier of the program (if one exists).

Some important remarks

  • If the customer does not exist, the API returns an error with the Customer_NotFound error code.
  • If the customer does not have any tier assigned, the response MessageResult will be "The consumer does not have a tier to remove.".
  • If the customer is already on the base tier, the tier cannot be removed. The response MessageResult will be "The consumer is on the base tier and does not have a tier to remove".
  • On success, the customer is automatically assigned to the base tier and the response MessageResult will be "Tier removed successfully.".

Response

The response contains:

  • MessageResult: a description of the outcome (success, no tier to remove, or base tier cannot be removed)
  • OldTierName: the name of the tier the customer was in before the removal (only present on success)
delete/v1/pvt/Customer/{originalId}/removetier

Request

  • Base URL
    https://api.bonifiq.com.br
  • Auth
    HTTP basic

Path parameters

originalIdstring required

Id from the client's store, usually email address or document

Response

The result of the removal including MessageResult and OldTierName, or an error response

ErrorMessagestring nullable

Error message returned when the request fails validation or processing. For warnings and successful responses, consumers should usually inspect Result, Code and Severity first.

ErrorCodeinteger nullable

Legacy numeric error code derived from internal API errors when available. This field is relevant only for error flows that use ApiResponseErrorDescription.

Codestring nullable

Endpoint-specific business code formatted as a two-digit string, such as 03 or 07. This field is available for success, warning and error outcomes.

CodeNamestring nullable

Symbolic enum name associated with Code, such as CheckoutNotFound.

Severity0 | 1 | 2

0 = Success 1 = Warning 2 = Error

HasWarningboolean

Convenience flag that is true when Severity is Warning. Warnings are valid 200 OK business outcomes and should not be handled as transport or validation errors.

HasErrorboolean

Indicates whether the request failed and should be handled as an error response. This flag is reserved for real API errors; warnings must keep this property as false.

Changes

No recorded changes to this operation across all 38 revisions of this API.