API reference
- Introduction
- Authentication
- Pagination
Resources
- Customers
- Activities
- Transactions
- Orders
- Emails
- Webhooks
Webhooks
- Introduction
- Webhook events
Refund Reward
curl --request POST \
--url https://api.loyaltylion.com/v2/customers/{merchant_id}/claimed_rewards/{claimed_reward_id}/refund
{
"claimed_reward": {
"id": 123,
"claimed_at": "<string>",
"point_cost": 123,
"redeemable": {
"redeemable_type": "fulfilment",
"fulfilled": true,
"fulfilled_at": "<string>",
"expires_on": null
},
"reward": {
"id": 123,
"title": "<string>",
"description": "<string>",
"sort_key": 123,
"content": {},
"point_cost": 123,
"method": "voucher",
"discount_type": "flat",
"discount_amount": 123,
"minimum_spend": 123,
"usage_limit": 123,
"min_redemption_amount": 1,
"max_redemption_amount": 1,
"max_free_shipping": "null",
"site_id": 123,
"target_site": {
"id": 123,
"name": "<string>",
"url": "<string>"
},
"order_type": "subscription",
"target_type": "all",
"target_collections": [
{
"id": 123,
"url": "<string>",
"restriction_text": "<string>"
}
],
"target_products": [
{
"id": 123,
"variant_id": 123,
"sku": "<string>",
"url": "<string>",
"image_url": "<string>",
"sort_key": 123,
"title": "<string>"
}
],
"session_options": "null",
"auto_refund_seconds": "null",
"expiry_options": {
"kind": "does_not_expire",
"seconds": "null"
},
"redeemable_expiry_options": "null",
"kind": "active_subscription_discount_voucher",
"recurring_cycle_limit": 123
},
"state": "approved",
"session": {
"kind": "cart",
"token": "<string>"
},
"auto_refund_at": "<string>",
"expires_at": "<string>"
},
"remote_resource_deleted": true
}
Path Parameters
The ID of the customer in your platform or ecommerce store
The ID of the claimed reward to refund
Response
ISO 8601
timestamp indicating when this reward was claimed
The number of points it cost to claim this reward
fulfilment
Indicates if this reward has been fulfilled
An ISO8601 timestamp representing when the reward was fulfilled, or null
if it is not yet fulfilled
This field is always null for fulfilment rewards because they do not expire
voucher
flat
, percentage
1
1
null
subscription
all
null
null
null
active_subscription_discount_voucher
approved
, declined
, expired
, pending
, void
ISO 8601
timestamp indicating when this reward will automatically be voided and refunded if it has not yet been used, or null
if not applicable
Deprecated in favour of auto_refund_at
Indicates if the redeemable resource associated with this reward was also deleted from the remote system. This will only be true
if LoyaltyLion manages the resource. For example, when refunding a voucher-based reward with a Shopify store LoyaltyLion will also delete the voucher in Shopify
curl --request POST \
--url https://api.loyaltylion.com/v2/customers/{merchant_id}/claimed_rewards/{claimed_reward_id}/refund
{
"claimed_reward": {
"id": 123,
"claimed_at": "<string>",
"point_cost": 123,
"redeemable": {
"redeemable_type": "fulfilment",
"fulfilled": true,
"fulfilled_at": "<string>",
"expires_on": null
},
"reward": {
"id": 123,
"title": "<string>",
"description": "<string>",
"sort_key": 123,
"content": {},
"point_cost": 123,
"method": "voucher",
"discount_type": "flat",
"discount_amount": 123,
"minimum_spend": 123,
"usage_limit": 123,
"min_redemption_amount": 1,
"max_redemption_amount": 1,
"max_free_shipping": "null",
"site_id": 123,
"target_site": {
"id": 123,
"name": "<string>",
"url": "<string>"
},
"order_type": "subscription",
"target_type": "all",
"target_collections": [
{
"id": 123,
"url": "<string>",
"restriction_text": "<string>"
}
],
"target_products": [
{
"id": 123,
"variant_id": 123,
"sku": "<string>",
"url": "<string>",
"image_url": "<string>",
"sort_key": 123,
"title": "<string>"
}
],
"session_options": "null",
"auto_refund_seconds": "null",
"expiry_options": {
"kind": "does_not_expire",
"seconds": "null"
},
"redeemable_expiry_options": "null",
"kind": "active_subscription_discount_voucher",
"recurring_cycle_limit": 123
},
"state": "approved",
"session": {
"kind": "cart",
"token": "<string>"
},
"auto_refund_at": "<string>",
"expires_at": "<string>"
},
"remote_resource_deleted": true
}