---
title: "Voidgiftcard"
method: POST
path: "/v2/giftcards/programs/{programId}/cards/{cardId}/void"
tags: ["Gift Cards"]
---

# Voidgiftcard

`POST /v2/giftcards/programs/{programId}/cards/{cardId}/void`

## Path parameters

- `cardId` string, required
- `programId` string, required

## Headers

- `idempotency-key` string, nullable
- `X-Eposn-Customer-Token` string, nullable
- `X-Eposn-Merchant-Token` string, nullable

## Request body

- VoidGiftCardRequest
  - `reason` string, required
  - `refundReference` string, nullable

## Response `200`

Successful Response

- ExpiredCardProcessingResponse
  - `success` boolean, required
  - `cardId` string, required
  - `action` string, required
  - `message` string, required
  - `newExpiresAt` string, date-time, nullable
  - `transactionId` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/loyalty/apis/loyaltydog.md) · [All operations](https://skmtc.net/loyalty/apis/loyaltydog/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/loyalty/loyaltydog/versions/42b7b22af2b6/schema)