v4

OpenAPI 3.0.02026-07-31811,0021.1 MB
Customer

Redeem points for a cashback value

post/v1/pvt/Customer/{id}/redeemcashback

Path parameters

idstring required

Request body

Valuenumber

Value (in R$) that will be added or removed from customer`s cashback balance

OperationType0 | 1

Identify if the points are being given or taken \n0 - Adding Points 1 - Removing Points

0 = AddPoints 1 = RemovePoints

Reasonstring

Information regarding why these cashback are being add/removed. Internal information only. Required.

ChangeKeystring

This is a unique key for this add/remove cashback. If you try to use the same key more than once it will result in error

CustomerReasonstring nullable

Customer-facing reason displayed in the customer's points history. Optional, max 255 characters. HTML tags are stripped automatically. If null, empty, or whitespace, the default system message is shown.

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.