Void a gift card (zero remaining balance)

POST

https://numueg.app/api/v1/stores/{store_id}/gift-cards/{gift_card_id}/void

Last modified:2026-09-19 16:39:33

x-numu-scope:catalog:write

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//gift-cards//void' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "note": "string"
}'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "id": "string",
        "last_four": "string",
        "initial_balance_cents": 0,
        "current_balance_cents": 0,
        "currency": "string",
        "status": "string",
        "customer_id": "string",
        "issued_by_user_id": "string",
        "issuing_order_id": "string",
        "expires_at": "string",
        "note": "string",
        "created_at": "string",
        "updated_at": "string"
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

List gift card transactions

Get inventory list