---
title: "Confirm the utilization of one or more rewards for a specified customer."
method: POST
path: "/api/v1alpha1/rewards:commit"
tags: ["RewardsService"]
---

# Confirm the utilization of one or more rewards for a specified customer.

`POST /api/v1alpha1/rewards:commit`

This endpoint is designed to validate the use of the cashback that was previously locked. Upon confirmation, the cashback is recorded as used and becomes unavailable for rollback.

To utilize this endpoint, you need to provide the lock_token generated during the locking process, along with the cashback value used and the unique identifier generated for the purchase. The purchase identifier must match the one intended for submission to Dito.

Optionally, you can use custom data to send data that will be used in the segmentation of the cashack consumption event.

Certain restrictions apply when committing. For instance, the cashback balance used must not be negative, the reward must not be expired, the lock must not have been generated more than 24 hours ago, and other similar criteria.

## Headers

- `Brand` string, required

## Request body

- V1alpha1CommitRewardsRequest
  - `lockId` string — Deprecated.
  - `lockToken` string, required — Lock identifier generated for rewards.
  - `valueUsed` string, required — Cashback value used on the order.
  - `orderId` string, required — Order ID.
  - `customData` object — Custom data, a map of string to string value.

## Response `200`

A successful response.

- object

## Other responses

- `400` — When an invalid request is sent.
- `401` — When the authentication is failed.
- `403` — when it was not authorized.
- `default` — An unexpected error response.

---

[API](https://skmtc.dev/dito/apis/authentication-api.md) · [All operations](https://skmtc.dev/dito/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dito/authentication-api/revisions/de4a5e2a412f/schema)