data-src=../../../../includes/commerce-only.md
redeemGiftCardBalanceAsStoreCredit mutation
The redeemGiftCardBalanceAsStoreCredit mutation converts the entire balance of a gift card to store credit. The gift card must be redeemable and cannot have a balance of 0 at the time you run the mutation. After successfully running the mutation, the value of the gift card changes to 0.
data-variant=info
data-slots=text
Run this mutation on behalf of logged-in customers only. Authorization tokens describes how to send a request as a customer.
Syntax
mutation {
redeemGiftCardBalanceAsStoreCredit(
input: GiftCardAccountInput
) {
GiftCardAccount
}
}
Reference
The redeemGiftCardBalanceAsStoreCredit reference provides detailed information about the types and fields defined in this mutation.
Example usage
The following example redeems the gift card with code "056MHP57TJ5C".
Request:
mutation {
redeemGiftCardBalanceAsStoreCredit(
input: {
gift_card_code: "056MHP57TJ5C"
}
) {
balance {
currency
value
}
code
expiration_date
}
}
Response:
{
"data": {
"redeemGiftCardBalanceAsStoreCredit": {
"balance": {
"currency": "USD",
"value": 0
},
"code": "056MHP57TJ5C",
"expiration_date": null
}
}
}
Errors
Error
Description
Gift card not foundThe specified
gift_card_code value does not exist in the giftcardaccount table or the amount has been already redeemed.Field GiftCardAccountInput.gift_card_code of required type String! was not providedThe value specified in the
GiftCardAccountInput.gift_card_code argument is empty.