---
title: "Create a store credit HOLD transaction"
method: POST
path: "/store_credits/{customerId}/hold"
tags: ["Store Credits"]
---

# Create a store credit HOLD transaction

`POST /store_credits/{customerId}/hold`

Creates a tranaction that represents temporary store credit redemption
That redemption should be reverted later AND may get followed by a REDEMPTION

## Path parameters

- `customerId` string, uuid, required

## Request body

- StoreCreditCreateHoldParams
  - `amount` number, double, required — The amount of the transaction.
  - `client_id` string — The client id is a unique transaction identifier. See StoreCreditTransactionParams

## Response `200`

A HOLD Transaction successfully created for a customer

- StoreCreditTransaction — A store credit operation
  - `amount` number, double — The amount of the transaction
  - `client_id` string — An operation idempotency identifier. The client must provide this and normally it should be the transaction id from the client system. An operation and it's reverse operation must have the same client_id
  - `created_at` string, date-time — The date time the transaction was created.
  - `id` string — transaction unique identifier (base64 encoded)
  - `notes` string — The notes associated with the transaction.
  - `sale_id` string, uuid — The sale id the transaction is associated with. This should be null for transactions initiated outside of Lightspeed Retail. If it is a sale id, it will be in UUID format.
  - `type` 'ISSUE' | 'REDEMPTION' | 'REVERSE' — The type of the transaction
  - `user_id` string, uuid — The user id of the person who performed the transaction (during a sale or a manual issue)

## Other responses

- `400` — Invalid parameters or insufficient store credit balance
- `404` — The given customer was not found.

---

[API](https://skmtc.net/lightspeedhq/apis/api-2026-07.md) · [All operations](https://skmtc.net/lightspeedhq/apis/api-2026-07/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightspeedhq/api-2026-07/versions/72d4ceb46dbb/schema)