`POST /api/v1/gift-cards/{id}/charge`
POST /api/v1/gift-cards/{id}/charge
POST
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.
Responses
GiftCardTransactionResponse
Gift card charged
ErrorBody
Gift card not found
ErrorBody
Invalid amount, inactive or expired card, or insufficient balance