curl --request POST \
--url 'https://api.stateset.com/api/v1/gift-cards/{id}/charge' \
--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"
}
Charge gift card
cards//charge
POST
/
api
/
v1
/
gift-cards
/
{id}
/
charge
curl --request POST \
--url 'https://api.stateset.com/api/v1/gift-cards/{id}/charge' \
--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}/charge`.
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 charged |
404 | Gift card not found |
422 | Invalid amount, inactive or expired card, or insufficient balance |
curl --request POST \
--url 'https://api.stateset.com/api/v1/gift-cards/{id}/charge' \
--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