2021 Call for Code Awards: Live from New York, with SNL’s Colin Jost! Learn more

Archived | Create a customer loyalty program with blockchain

Archived content

Archive date: 2019-05-01

This content is no longer being updated or maintained. The content is provided “as is.” Given the rapid evolution of technology, some content, steps, or illustrations may have changed.

Note: This pattern focuses on older technology (e.g. Hyperledger Fabric APIs prior to Fabric 1.4). Therefore, there is no support for this pattern and it will be archived on May 1, 2019. You are welcome to use up to that date, but we recommend that you begin working with the [updated release(/patterns/customer-loyalty-program-with-iks-saas-v2-fabric/).


A customer loyalty program allows companies to attract new customers and retain customers with special deals and discounts. The programs are typically based on a points system, in which a program member earns points on purchases, which can be redeemed on special deals. Loyalty programs can have multiple companies as partners to serve a customer base. For consumers managing an array of loyalty programs, blockchain could provide instant redemption and exchange for multiple loyalty point currencies on a single platform. With only one digital “wallet” for points, consumers would not have to hunt for each program’s options, limitations, and redemption rules.


In this developer code pattern, we will create a customer loyalty program with blockchain using Hyperledger Composer 0.19.5 API and a Node.js web application. The application will allow members to register on the network and sign in to perform transactions. Members will be able to view the partners on the network and perform transactions with them. These transactions will include earning points on purchases and redeeming those points on deals. Members will be able to view all their transactions as part of the blockchain ledger.

The application will allow partners to register on the network. Once registered, they can sign in to view transactions with them made by members. Partners will not have access to members except in the transactions. The application demonstrates a basic dashboard for the partners, which displays total points allocated and redeemed by analyzing the transactions made with them.

This pattern is for developers looking to start building blockchain applications with Hyperledger Composer. When you have completed this pattern, you will understand how to:

  • Create a basic business network using Hyperledger Composer
  • Deploy the network to an instance of Hyperledger Fabric locally and to IBM Blockchain
  • Build a Node.js web application to interact with the blockchain network using Composer API



  1. Member is registered on the network.
  2. Member can sign in to make transactions to earn points, redeem points, and view transactions.
  3. Partner is registered on the network.
  4. Partner can sign in to view transactions and display dashboard.


Find the detailed steps for this pattern in the README.