Store APIGift cards
Redeem a Gift Card
Redeem a gift card by its ID or code. The gift card will be added to the logged-in customer's store credit account.
connect.sid<token>
In: cookie
Path Parameters
idOrCode*string
The gift card's ID or code.
Query Parameters
fields?string
Comma-separated fields that should be included in the returned data.
if a field is prefixed with + it will be added to the default fields, using - will remove it from the default fields.
without prefix it will replace the entire default fields.
Header Parameters
x-publishable-api-key*string
Publishable API Key created in the Medusa Admin.
Response Body
application/json
application/json
text/plain
application/json
application/json
application/json
application/json
curl -X POST "https://{tenant}.api.myxclade.com/store/gift-cards/string/redeem" \ -H "x-publishable-api-key: string"{
"gift_card": {
"customer": {
"id": "string",
"email": "user@example.com",
"default_billing_address_id": "string",
"default_shipping_address_id": "string",
"company_name": "string",
"first_name": "string",
"last_name": "string",
"addresses": [
{
"id": "string",
"address_name": "string",
"is_default_shipping": true,
"is_default_billing": true,
"customer_id": "string",
"company": "string",
"first_name": "string",
"last_name": "string",
"address_1": "string",
"address_2": "string",
"city": "string",
"country_code": "usd",
"province": "us-ca",
"postal_code": "string",
"phone": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"phone": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z"
},
"line_item": {
"id": "string",
"title": "string",
"subtitle": "string",
"thumbnail": "string",
"variant": {
"options": [
{
"id": "string",
"value": "string",
"option": {},
"option_id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z"
}
],
"product": {},
"length": 0,
"title": "string",
"metadata": {},
"id": "string",
"width": 0,
"weight": 0,
"height": 0,
"origin_country": "string",
"hs_code": "string",
"mid_code": "string",
"material": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"product_id": "string",
"sku": "string",
"barcode": "string",
"ean": "string",
"upc": "string",
"allow_backorder": true,
"manage_inventory": true,
"inventory_quantity": 0,
"variant_rank": 0,
"calculated_price": {
"id": "string",
"is_calculated_price_price_list": true,
"is_calculated_price_tax_inclusive": true,
"calculated_amount": 0,
"calculated_amount_with_tax": 0,
"calculated_amount_without_tax": 0,
"is_original_price_price_list": true,
"is_original_price_tax_inclusive": true,
"original_amount": 0,
"currency_code": "usd",
"calculated_price": {},
"original_price": {},
"original_amount_with_tax": 0,
"original_amount_without_tax": 0
}
},
"variant_id": "string",
"product": {
"categories": [
{}
],
"type": {
"id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"value": "string"
},
"length": 0,
"title": "string",
"status": "draft",
"options": [
{
"id": "string",
"title": "string",
"product": {},
"product_id": "string",
"values": [
{
"id": "string",
"value": "string",
"option": {},
"option_id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z"
}
],
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z"
}
],
"description": "string",
"id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"variants": [
{
"options": [
{
"id": "string",
"value": "string",
"option": {},
"option_id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z"
}
],
"product": {},
"length": 0,
"title": "string",
"metadata": {},
"id": "string",
"width": 0,
"weight": 0,
"height": 0,
"origin_country": "string",
"hs_code": "string",
"mid_code": "string",
"material": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"product_id": "string",
"sku": "string",
"barcode": "string",
"ean": "string",
"upc": "string",
"allow_backorder": true,
"manage_inventory": true,
"inventory_quantity": 0,
"variant_rank": 0,
"calculated_price": {
"id": "string",
"is_calculated_price_price_list": true,
"is_calculated_price_tax_inclusive": true,
"calculated_amount": 0,
"calculated_amount_with_tax": 0,
"calculated_amount_without_tax": 0,
"is_original_price_price_list": true,
"is_original_price_tax_inclusive": true,
"original_amount": 0,
"currency_code": "usd",
"calculated_price": {},
"original_price": {},
"original_amount_with_tax": 0,
"original_amount_without_tax": 0
}
}
],
"handle": "string",
"subtitle": "string",
"is_giftcard": true,
"thumbnail": "string",
"width": 0,
"weight": 0,
"height": 0,
"origin_country": "string",
"hs_code": "string",
"mid_code": "string",
"material": "string",
"collection": {
"id": "string",
"title": "string",
"handle": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"products": [
{}
],
"metadata": {}
},
"collection_id": "string",
"type_id": "string",
"tags": [
{
"id": "string",
"value": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"metadata": {}
}
],
"images": [
{
"id": "string",
"url": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"metadata": {},
"rank": 0
}
],
"discountable": true,
"external_id": "string",
"deleted_at": "2019-08-24T14:15:22Z"
},
"product_id": "string",
"product_title": "string",
"product_description": "string",
"product_subtitle": "string",
"product_type": "string",
"product_collection": "string",
"product_handle": "string",
"variant_sku": "string",
"variant_barcode": "string",
"variant_title": "string",
"variant_option_values": {
"Color": "Blue"
},
"requires_shipping": true,
"is_discountable": true,
"is_tax_inclusive": true,
"compare_at_unit_price": 0,
"unit_price": 0,
"quantity": 0,
"tax_lines": [
{
"item": {
"id": "string",
"title": "string",
"subtitle": "string",
"thumbnail": "string",
"variant": {
"id": "string",
"title": "string",
"sku": "string",
"barcode": "string",
"ean": "string",
"upc": "string",
"allow_backorder": true,
"manage_inventory": true,
"inventory_quantity": 0,
"hs_code": "string",
"origin_country": "string",
"mid_code": "string",
"material": "string",
"weight": 0,
"length": 0,
"height": 0,
"width": 0,
"variant_rank": 0,
"options": [
{}
],
"product": {},
"product_id": "string",
"calculated_price": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"metadata": {}
},
"variant_id": "string",
"product": {
"id": "string",
"title": "string",
"handle": "string",
"subtitle": "string",
"description": "string",
"is_giftcard": true,
"status": "draft",
"thumbnail": "string",
"width": 0,
"weight": 0,
"length": 0,
"height": 0,
"origin_country": "string",
"hs_code": "string",
"mid_code": "string",
"material": "string",
"collection": {},
"collection_id": "string",
"categories": [
{}
],
"type": {},
"type_id": "string",
"tags": [
{}
],
"variants": [
{}
],
"options": [
{}
],
"images": [
{}
],
"discountable": true,
"external_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"metadata": {}
},
"product_id": "string",
"product_title": "string",
"product_description": "string",
"product_subtitle": "string",
"product_type": "string",
"product_collection": "string",
"product_handle": "string",
"variant_sku": "string",
"variant_barcode": "string",
"variant_title": "string",
"variant_option_values": {},
"requires_shipping": true,
"is_discountable": true,
"is_tax_inclusive": true,
"compare_at_unit_price": 0,
"unit_price": 0,
"quantity": 0,
"tax_lines": [
{
"item": {},
"item_id": "string",
"total": 0,
"subtotal": 0,
"id": "string",
"description": "string",
"tax_rate_id": "string",
"code": "string",
"rate": 0,
"provider_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"adjustments": [
{
"item": {},
"item_id": "string",
"id": "string",
"code": "string",
"amount": 0,
"order_id": "string",
"description": "string",
"promotion_id": "string",
"provider_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"detail": {
"id": "string",
"item_id": "string",
"item": {},
"quantity": 0,
"fulfilled_quantity": 0,
"delivered_quantity": 0,
"shipped_quantity": 0,
"return_requested_quantity": 0,
"return_received_quantity": 0,
"return_dismissed_quantity": 0,
"written_off_quantity": 0,
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"metadata": {},
"original_total": 0,
"original_subtotal": 0,
"original_tax_total": 0,
"item_total": 0,
"item_subtotal": 0,
"item_tax_total": 0,
"total": 0,
"subtotal": 0,
"tax_total": 0,
"discount_total": 0,
"discount_tax_total": 0,
"refundable_total": 0,
"refundable_total_per_unit": 0
},
"item_id": "string",
"total": 0,
"subtotal": 0,
"id": "string",
"description": "string",
"tax_rate_id": "string",
"code": "string",
"rate": 0,
"provider_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"adjustments": [
{
"item": {
"id": "string",
"title": "string",
"subtitle": "string",
"thumbnail": "string",
"variant": {
"id": "string",
"title": "string",
"sku": "string",
"barcode": "string",
"ean": "string",
"upc": "string",
"allow_backorder": true,
"manage_inventory": true,
"inventory_quantity": 0,
"hs_code": "string",
"origin_country": "string",
"mid_code": "string",
"material": "string",
"weight": 0,
"length": 0,
"height": 0,
"width": 0,
"variant_rank": 0,
"options": [
{}
],
"product": {},
"product_id": "string",
"calculated_price": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"metadata": {}
},
"variant_id": "string",
"product": {
"id": "string",
"title": "string",
"handle": "string",
"subtitle": "string",
"description": "string",
"is_giftcard": true,
"status": "draft",
"thumbnail": "string",
"width": 0,
"weight": 0,
"length": 0,
"height": 0,
"origin_country": "string",
"hs_code": "string",
"mid_code": "string",
"material": "string",
"collection": {},
"collection_id": "string",
"categories": [
{}
],
"type": {},
"type_id": "string",
"tags": [
{}
],
"variants": [
{}
],
"options": [
{}
],
"images": [
{}
],
"discountable": true,
"external_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"deleted_at": "2019-08-24T14:15:22Z",
"metadata": {}
},
"product_id": "string",
"product_title": "string",
"product_description": "string",
"product_subtitle": "string",
"product_type": "string",
"product_collection": "string",
"product_handle": "string",
"variant_sku": "string",
"variant_barcode": "string",
"variant_title": "string",
"variant_option_values": {},
"requires_shipping": true,
"is_discountable": true,
"is_tax_inclusive": true,
"compare_at_unit_price": 0,
"unit_price": 0,
"quantity": 0,
"tax_lines": [
{
"item": {},
"item_id": "string",
"total": 0,
"subtotal": 0,
"id": "string",
"description": "string",
"tax_rate_id": "string",
"code": "string",
"rate": 0,
"provider_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"adjustments": [
{
"item": {},
"item_id": "string",
"id": "string",
"code": "string",
"amount": 0,
"order_id": "string",
"description": "string",
"promotion_id": "string",
"provider_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"detail": {
"id": "string",
"item_id": "string",
"item": {},
"quantity": 0,
"fulfilled_quantity": 0,
"delivered_quantity": 0,
"shipped_quantity": 0,
"return_requested_quantity": 0,
"return_received_quantity": 0,
"return_dismissed_quantity": 0,
"written_off_quantity": 0,
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"metadata": {},
"original_total": 0,
"original_subtotal": 0,
"original_tax_total": 0,
"item_total": 0,
"item_subtotal": 0,
"item_tax_total": 0,
"total": 0,
"subtotal": 0,
"tax_total": 0,
"discount_total": 0,
"discount_tax_total": 0,
"refundable_total": 0,
"refundable_total_per_unit": 0
},
"item_id": "string",
"id": "string",
"code": "string",
"amount": 0,
"order_id": "string",
"description": "string",
"promotion_id": "string",
"provider_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"detail": {
"id": "string",
"item_id": "string",
"item": {
"variant": {
"options": [
{}
],
"product": {},
"length": 0,
"title": "string",
"id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"product_id": "string",
"width": 0,
"weight": 0,
"height": 0,
"origin_country": "string",
"hs_code": "string",
"mid_code": "string",
"material": "string",
"deleted_at": "2019-08-24T14:15:22Z",
"sku": "string",
"barcode": "string",
"ean": "string",
"upc": "string",
"allow_backorder": true,
"manage_inventory": true,
"inventory_quantity": 0,
"variant_rank": 0,
"calculated_price": {}
},
"product": {
"collection": {},
"categories": [
{}
],
"variants": [
{}
],
"type": {},
"tags": [
{}
],
"options": [
{}
],
"images": [
{}
],
"length": 0,
"title": "string",
"status": "draft",
"description": "string",
"id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"subtitle": "string",
"thumbnail": "string",
"handle": "string",
"is_giftcard": true,
"width": 0,
"weight": 0,
"height": 0,
"origin_country": "string",
"hs_code": "string",
"mid_code": "string",
"material": "string",
"collection_id": "string",
"type_id": "string",
"discountable": true,
"external_id": "string",
"deleted_at": "2019-08-24T14:15:22Z"
},
"tax_lines": [
{
"item": {},
"item_id": "string",
"total": 0,
"subtotal": 0,
"id": "string",
"description": "string",
"tax_rate_id": "string",
"code": "string",
"rate": 0,
"provider_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"adjustments": [
{
"item": {},
"item_id": "string",
"id": "string",
"code": "string",
"amount": 0,
"order_id": "string",
"description": "string",
"promotion_id": "string",
"provider_id": "string",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
],
"detail": {
"id": "string",
"item_id": "string",
"item": {},
"quantity": 0,
"fulfilled_quantity": 0,
"delivered_quantity": 0,
"shipped_quantity": 0,
"return_requested_quantity": 0,
"return_received_quantity": 0,
"return_dismissed_quantity": 0,
"written_off_quantity": 0,
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"title": "string",
"id": "string",
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"item_total": 0,
"item_subtotal": 0,
"item_tax_total": 0,
"original_total": 0,
"original_subtotal": 0,
"original_tax_total": 0,
"total": 0,
"subtotal": 0,
"tax_total": 0,
"discount_total": 0,
"discount_tax_total": 0,
"subtitle": "string",
"thumbnail": "string",
"variant_id": "string",
"product_id": "string",
"product_title": "string",
"product_description": "string",
"product_subtitle": "string",
"product_type": "string",
"product_collection": "string",
"product_handle": "string",
"variant_sku": "string",
"variant_barcode": "string",
"variant_title": "string",
"variant_option_values": {},
"requires_shipping": true,
"is_discountable": true,
"is_tax_inclusive": true,
"compare_at_unit_price": 0,
"unit_price": 0,
"quantity": 0,
"refundable_total": 0,
"refundable_total_per_unit": 0
},
"quantity": 0,
"fulfilled_quantity": 0,
"delivered_quantity": 0,
"shipped_quantity": 0,
"return_requested_quantity": 0,
"return_received_quantity": 0,
"return_dismissed_quantity": 0,
"written_off_quantity": 0,
"metadata": {},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
},
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z",
"metadata": {},
"original_total": 0,
"original_subtotal": 0,
"original_tax_total": 0,
"item_total": 0,
"item_subtotal": 0,
"item_tax_total": 0,
"total": 0,
"subtotal": 0,
"tax_total": 0,
"discount_total": 0,
"discount_tax_total": 0,
"refundable_total": 0,
"refundable_total_per_unit": 0,
"product_type_id": "string"
},
"id": "string",
"code": "string",
"status": "pending",
"value": 0,
"currency_code": "usd",
"customer_id": "string",
"reference_id": "string",
"note": "string",
"reference": "string",
"expires_at": "2019-08-24T14:15:22Z",
"created_at": "2019-08-24T14:15:22Z",
"updated_at": "2019-08-24T14:15:22Z"
}
}{
"message": "Discount must be set to dynamic",
"type": "not_allowed"
}"Unauthorized"{
"message": "Entity with id 1 was not found",
"type": "not_found"
}{
"code": "unknown_error",
"message": "The request conflicted with another request. You may retry the request with the provided Idempotency-Key.",
"type": "QueryRunnerAlreadyReleasedError"
}{
"code": "invalid_request_error",
"message": "Discount with code TEST already exists.",
"type": "duplicate_error"
}{
"code": "api_error",
"message": "An error occured while hashing password",
"type": "database_error"
}Get a Gift Card
Retrieve a gift card by its ID or code. You can expand the gift card's relations or select the fields that should be returned.
List Customer's Store Credit Accounts
Retrieve the logged-in customer's store credit accounts. The store credit accounts can be filtered by fields such as `id`. The store credit accounts can also be sorted or paginated.