Skip to main content
Suggest Edits This guide shows a workflow for combining loyalty points from multiple cards. A common use case is to allow a customer to redeem a reward if the number of points on a single card is not enough.
  • Points can be transferred between cards in the same and different loyalty campaigns.
  • Points can be transferred to the same and different customers.

​
Reward qualification

First, we need to call the qualification endpoint. It returns a list of loyalty cards that can be used for redeeming a reward specified in the request. 
{
    "customer" : {
      "id" : "cust_D01yXiZdzuMl149QpUFBG58E",
      "source_id" : "src_id",
      "name": "Jan Kowalski"
    },
    "reward": {
		"id": "rew_BLeJDzhaNTxpW3tFFhuFM5Wl",
		"assignment_id": "rewa_sxrvjMvQAtip54kV81FBxs2V"
	}
}
The returned cards belong to the given customer but the customer parameter is optional. If you leave it not defined, the method will return all loyalty card codes which can be used to redeem a reward.

​
Loyalty card validation

The validation API method should be used to verify whether the customer has enough points for receiving a reward. Here’s an endpoint and example request. POST: {{url}}/vouchers/{code}/validate
  • code - a code of customer’s loyalty card
An example request body and a response: 
{
    "customer" : {
      "id" : "cust_D01yXiZdzuMl149QpUFBG58E",
      "source_id" : "src_id",
      "name": "Jan Kowalski"
    },
    "reward": {
		"id": "rew_BLeJDzhaNTxpW3tFFhuFM5Wl",
		"assignment_id": "rewa_sxrvjMvQAtip54kV81FBxs2V"
  	}
}
In the response, you can see that the customer doesn’t have enough points to get the reward

​
The loyalty points transfer

This entity describes loyalty points transfer between Campaigns and Customers. If the customer has two or more assigned loyalty cards, Voucherify gives the opportunity to transfer points from one card to another - e.g., when the customer does not have enough points on the loyalty card to receive the reward. Points can be transferred between cards in the same and different loyalty campaigns and for the same and different customers. To transfer points from one card to another ({id}), we need to call the transfer endpoint with the following request body: POST: https://api.voucherify.io/v1/loyalties/{campaignId}/members/{memberId}/transfers In the path parameters, you need to include:
  • campaignId - a unique identifier of the loyalty campaign containing the voucher to which the loyalty points are to be sent.
  • memberId – a unique code identifying the loyalty card to which the user wants to transfer loyalty points.
In the body parameters, you need to add the following data:
  • code – a unique identifier of the loyalty card from which you want to transfer points.
  • points – the number of loyalty points that you want to transfer to another loyalty card.
The number of points in the request body cannot be higher than the current balance on the loyalty card.
Exemplary path: https://api.voucherify.io/v1/loyalties/camp_qOrtQUT8sRZ0p6dEAkFpx97p/members/6PMax4A9/transfers 
[
   {
      "campaign_id": "camp_dYaLHvcIMdUZ2yINBABKDECE",
      "code": "pLUJhg7S",
      "points": 200
   }
]
As a result, the balance on both cards has changed.

​
Points redemption

Finally, we can redeem the points from our card. POST: https://api.voucherify.io/v1/loyalties/{campaignId}/members/{memberId}/redemption Where campaignId is a unique id of a loyalty campaign and the memberId is a loyalty card code. 
{
	"reward": {
		"id": "rew_BLeJDzhaNTxpW3tFFhuFM5Wl"
	}
}
In the dashboard, you can see that the points from the loyalty card were spent on the reward and the balance was updated.
⌘I