curl --request POST \
--url 'https://api.stateset.com/api/v1/gift-cards/{id}/refund' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"amount": "49.00",
"reference_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"amount": "49.00",
"balance_after": "string",
"created_at": "2026-08-31T14:22:05Z",
"gift_card_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"reference_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"transaction_type": "string"
}
Refund a gift card
cards//refund
POST
/
api
/
v1
/
gift-cards
/
{id}
/
refund
curl --request POST \
--url 'https://api.stateset.com/api/v1/gift-cards/{id}/refund' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"amount": "49.00",
"reference_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"amount": "49.00",
"balance_after": "string",
"created_at": "2026-08-31T14:22:05Z",
"gift_card_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"reference_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"transaction_type": "string"
}
Cards/{id}/refund`.
Path parameters
string
required
Gift card ID (UUID)
Request body
GiftCardAmountRequest
string
required
Amount to charge (debit) or refund (credit). Must be positive.
string,null
Optional reference (e.g. order ID) recorded on the transaction.
Response
GiftCardTransactionResponse
string
required
string
required
string (date-time)
required
string
required
string
required
string,null
string
required
Status codes
| Code | Meaning |
|---|---|
200 | Gift card refunded |
404 | Gift card not found |
422 | Invalid amount or disabled card |
curl --request POST \
--url 'https://api.stateset.com/api/v1/gift-cards/{id}/refund' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"amount": "49.00",
"reference_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"amount": "49.00",
"balance_after": "string",
"created_at": "2026-08-31T14:22:05Z",
"gift_card_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"reference_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"transaction_type": "string"
}
Last modified on August 31, 2026