This service is used to send commands to be processed by the Reward Processor service. Each command sent will result in the Qoin user receiving points, and the transaction will be recorded in the Transaction History.

Here's the detail of service action in Loyalty Reward Task :

Loyalty Reward - Transaction

This API is used to retrieve loyalty reward data earned through transactions.

Payload Data

Name	Data Type	Description
trxId	String	Id Transaction
memberId	String	Id Member
memberName	String	Member Name
refference	String	Reference Number
userFromStatus	String	Status User Sender
userId	String	Id User
userIdShare	String	Id User Sender
deviceType	String	Device Type
installId	String	Install Id
signature	String	Signature Loyalty
trxAmount	String	Transaction Amount
trxDate	String	Transaction Date

Example Request

{
   "Subject":"loyalty",
   "SubjectType":"reward",
   "SubjectIdentifier":"task",
   "Action":"transaction",
   "ResourceType":"null",
   "Resource":"null",
   "ResourceId":"null",
   "Data":{
      "trxId":0,
      "memberId":123,
      "memberName":"agung",
      "refference":"ref123",
      "userFromStatus":0,
      "userId":123,
      "userIdShare":456,
      "deviceType":"android",
      "installId":"installId",
      "signature":"sssss",
      "data":[
         {
            "trxAmount":10000,
            "trxDate":""
         }
      ]
   }
}

{
    "TicketId": "34352d31-69bb2a81-cb51-4595-b621-bfdd34b0841a",
    "Subject": "loyalty",
    "SubjectType": "reward",
    "SubjectIdentifier": "task",
    "Action": "transaction",
    "ResourceType": "data",
    "Resource": "none",
    "ResourceId": "none",
    "Result": null,
    "Status": "success",
    "Message": "Success process data(Success)",
    "StatusCode": 200
}

Loyalty Reward - Lucky Draw

This API is used to retrieve loyalty reward data obtained through the lucky draw feature.

Payload Data

Name	Data Type	Description
trxId	Integer	Id Transaction
memberId	Integer	Id Member
memberName	String	Member Name
refference	String	Reference Number
userFromStatus	Integer	Status User Sender
userId	Integer	Id User
userIdShare	Integer	Id User Sender
deviceType	String	Device Type
installId	String	Install Id
signature	String	Signature Loyalty
data	Object	Data Object
data.trxAmount	Float	Transaction Amount
data.trxDate	Datetime	Transaction Date

Example Request

{
   "Subject":"loyalty",
   "SubjectType":"reward",
   "SubjectIdentifier":"task",
   "Action":"luckydraw",
   "ResourceType":"null",
   "Resource":"null",
   "ResourceId":"null",
   "ScopeSource":"",
   "Data":{
      "trxId":0,
      "memberId":123,
      "memberName":"agung",
      "refference":"ref123",
      "userFromStatus":0,
      "userId":123,
      "userIdShare":456,
      "deviceType":"android",
      "installId":"installId",
      "signature":"sssss",
      "data":[
         {
            "trxAmount":10000,
            "trxDate":""
         }
      ]
   }
}

{
    "TicketId": "34352d31-69bb2a81-cb51-4595-b621-bfdd34b0841a",
    "Subject": "loyalty",
    "SubjectType": "reward",
    "SubjectIdentifier": "task",
    "Action": "luckydraw",
    "ResourceType": "data",
    "Resource": "none",
    "ResourceId": "none",
    "Result": null,
    "Status": "success",
    "Message": "Success process data(Success)",
    "StatusCode": 200
}

Loyalty Reward - Register

This API is used to retrieve loyalty reward data earned during user registration.

Payload Data

Name	Data Type	Description
trxId	Integer	Id Transaction
memberId	Integer	Id Member
memberName	String	Member Name
refference	String	Reference Number
userFromStatus	String	Status User Sender
userId	String	Id User
userIdShare	String	Id User Sender
deviceType	String	Device Type
installId	String	Install Id
signature	String	Signature Loyalty
Data	Object	Data Object
data.trxAmount	String	Transaction Amount
data.trxDate	String	Transaction Date

🚧
Notes
The registration process is carried out during the first New Member process, and make sure that the Membership service is integrated with the Loyalty Reward Task service.

Example Request

{
   "Subject":"loyalty",
   "SubjectType":"reward",
   "SubjectIdentifier":"task",
   "Action":"register",
   "ResourceType":"null",
   "Resource":"null",
   "ResourceId":"null",
   "ScopeSource":"",
   "Data":{
      "trxId":0,
      "memberId":123,
      "memberName":"agung",
      "refference":"ref123",
      "userFromStatus":0,
      "userId":123,
      "userIdShare":456,
      "deviceType":"android",
      "installId":"installId",
      "signature":"sssss",
      "data":[
         {
            "trxAmount":10000,
            "trxDate":""
         }
      ]
   }
}

{
    "TicketId": "34352d31-69bb2a81-cb51-4595-b621-bfdd34b0841a",
    "Subject": "loyalty",
    "SubjectType": "reward",
    "SubjectIdentifier": "task",
    "Action": "register",
    "ResourceType": "data",
    "Resource": "none",
    "ResourceId": "none",
    "Result": null,
    "Status": "success",
    "Message": "Success process data(Success)",
    "StatusCode": 200
}

Loyalty Reward - Register Referral

This API is used to retrieve loyalty reward data from user registration using a referral code.

Payload Data

Name	Data Type	Description
trxId	Integer	Id Transaction
Data	Object	Data Object
memberId	Integer	Id Member
memberName	String	Fullname member
memberQtagPhone	String	Member Qtag User Phone
refference	String	Reference Number
userFromStatus	Integer	Status User Sender
userId	String	Id User
userIdShare	String	Id User Sender
deviceType	String	Device Type
installId	String	Install Id
signature	String	Signature Loyalty
data.trxAmount	Float	Transaction Amount
data.trxDate	Datetime	Transaction Date
date	Datetime	Date time request

Example Request

{
    "Subject": "loyalty",
    "SubjectType": "reward",
    "SubjectIdentifier": "task",
    "Action": "registerreferral",
    "ResourceType": "null",
    "Resource": "null",
    "ResourceId": "null",
    "Data": {
      "data": [
        {
          "trxAmount": 1000,
          "trxDate": "2024-04-30 10:30:00"
        }
      ],
      "deviceType": "android",
      "installId": "S21+",
      "memberId": 2784,
      "memberName": "Fares",
      "memberQtagPhone": "Q12345",
      "refference": "ref123",
      "signature": "Q5PR7cAbCq8JGyQknqhSSVa0ElbASVbg6olfavCmszTtk27IP1JWIRFKuQFOjqEiT0QFvWcqGdchIjl+11ZQqce8vuRfPvmZeaM0nrkRr/kGHWtBf0CWgTJCAPKmddTw0sZUHrwg/8bl41VpQjcxGdPOqRbllTMsTViychxAFVY=",
      "trxId": 0,
      "userFromStatus": 0,
      "userId": 92479,
      "userIdShare": 0
    }
}

{
    "TicketId": "34352d31-69bb2a81-cb51-4595-b621-bfdd34b0841a",
    "Subject": "loyalty",
    "SubjectType": "reward",
    "SubjectIdentifier": "task",
    "Action": "registerreferral",
    "ResourceType": "data",
    "Resource": "none",
    "ResourceId": "none",
    "Result": null,
    "Status": "success",
    "Message": "Success process data(Success)",
    "StatusCode": 200
}

Loyalty Reward - Transaction Referral

This API is used to retrieve loyalty reward data from transactions using a referral code.

Payload Data

Name	Data Type
trxId	String
memberId	String
memberName	String
refference	String
userFromStatus	String
userId	String
userIdShare	String
deviceType	String
installId	String
signature	String
trxAmount	String
trxDate	String
productID	String

Example Request

{
  "Subject": "loyalty",
  "SubjectType": "reward",
  "SubjectIdentifier": "task",
  "Action": "transactionreferral",
  "ResourceType": "null",
  "Resource": "null",
  "ResourceId": "null",
  "Data": {
    "data": [
      {
        "trxAmount": 1000,
        "trxDate": "2024-04-30 10:30:00",
        "product_id": 10
      }
    ],
    "deviceType": "android",
    "installId": "S21+",
    "memberId": 2784,
    "memberName": "Fares",
    "memberQtagPhone": "Q12345",
    "refference": "ref123",
    "signature": "Q5PR7cAbCq8JGyQknqhSSVa0ElbASVbg6olfavCmszTtk27IP1JWIRFKuQFOjqEiT0QFvWcqGdchIjl+11ZQqce8vuRfPvmZeaM0nrkRr/kGHWtBf0CWgTJCAPKmddTw0sZUHrwg/8bl41VpQjcxGdPOqRbllTMsTViychxAFVY=",
    "trxId": 0,
    "userFromStatus": 0,
    "userId": 92479,
    "userIdShare": 0
  }
}

Loyalty Reward - Daily Check In

Payload Data

Name	Data Type
trxAmount	String
trxDate	String
deviceType	String
installId	String
memberId	String
memberName	String
refference	String
signature	String
trxId	String
userFromStatus	String
userId	String
userIdShare	String
Date	String

Example Request

{
    "Subject": "loyalty",
    "SubjectType": "reward",
    "SubjectIdentifier": "task",
    "Action": "dailycheckin",
    "ResourceType": "null",
    "Resource": "null",
    "ResourceId": "null",
    "Data": {
      "data": [
        {
          "trxAmount": 0,
          "trxDate": "2024-04-30 10-30-00"
        }
      ],
      "deviceType": "android",
      "installId": "S21+",
      "memberId": 2784,
      "memberName": "Fares",
      "refference": "ref123",
      "signature": "Q5PR7cAbCq8JGyQknqhSSVa0ElbASVbg6olfavCmszTtk27IP1JWIRFKuQFOjqEiT0QFvWcqGdchIjl+11ZQqce8vuRfPvmZeaM0nrkRr/kGHWtBf0CWgTJCAPKmddTw0sZUHrwg/8bl41VpQjcxGdPOqRbllTMsTViychxAFVY=",
      "trxId": 0,
      "userFromStatus": 0,
      "userId": 92479,
      "userIdShare": 0
    }
}

Loyalty Reward - Product SKU

This API is used for the SKU (Stock Keeping Unit) feature.

Payload Data

Name	Data Type	Description
data	Object	Data Object
data.trxAmount	Float	Transaction Amount
data.trxDate	Datetime	Transaction Date
deviceType	String	User device type
installId	String	Id device installed
memberId	Integer	Id member
memberName	String	Fullname member
memberQtagPhone	String	Qtag member
refference	String	Reference Member
signature	String	Signature Loyalty
trxId	Integer	Id transaction
userFromStatus	Integer	Status user sender
userId	Integer	Id user
userIdShare	Integer	Id user sender
Date	Datetime	Date time sending request

Example Request

{
  "Subject": "loyalty",
  "SubjectType": "reward",
  "SubjectIdentifier": "task",
  "Action": "productsku",
  "ResourceType": "null",
  "Resource": "null",
  "ResourceId": "null",
  "Data": {
    "data": [
      {
        "trxAmount": 0,
        "trxDate": "2024-04-30 10-30-00",
        "product_code": "T30H"
      }
    ],
    "deviceType": "android",
    "installId": "S21+",
    "memberId": 2784,
    "memberName": "Fares",
    "refference": "ref123",
    "signature": "Q5PR7cAbCq8JGyQknqhSSVa0ElbASVbg6olfavCmszTtk27IP1JWIRFKuQFOjqEiT0QFvWcqGdchIjl+11ZQqce8vuRfPvmZeaM0nrkRr/kGHWtBf0CWgTJCAPKmddTw0sZUHrwg/8bl41VpQjcxGdPOqRbllTMsTViychxAFVY=",
    "trxId": 0,
    "userFromStatus": 0,
    "userId": 92479,
    "userIdShare": 0
  },
  "Date": "2024-04-30 15:02:08.670 WIB"
}

{
    "TicketId": "34352d31-69bb2a81-cb51-4595-b621-bfdd34b0841a",
    "Subject": "loyalty",
    "SubjectType": "reward",
    "SubjectIdentifier": "task",
    "Action": "productsku",
    "ResourceType": "data",
    "Resource": "none",
    "ResourceId": "none",
    "Result": null,
    "Status": "success",
    "Message": "Success process data(Success)",
    "StatusCode": 200
}