Reward Processor service handles the management and execution of reward and promo processes. This includes processing rewards from referral programs, daily check-ins, lucky draws, and other promotional activities related to transactions.

Action Reward Processor Loyalty

Action method in Reward Processor Loyalty :

Register
Register Referral
Transaction Promo
Transaction Referral
Transaction Lucky Draw

Register Promo

This API is used to initiate the reward promo process through user registration.

Payload Data

Name	Data Type	Description
id	Int	data identify
command	String	Command Process
transaction	Object	Transaction Object
transaction.date	Datetime	Date Time Register

Response Body

Name	Data Type	Description
TicketId	String	Ticket ID Register

Example Request

{
  "Subject":"loyalty",
  "SubjectType":"reward",
  "SubjectIdentifier":"processor",
  "Action":"register",
  "ResourceType":"",
  "Resource":"",
  "ResourceId":"",
  "Data":{
    "id": 461,
    "command": "register",
    "transaction": [
      {
        "date": "2025-03-31T11:22:06"
      }
    ]
  }
}

{
  "code": 200,
  "message": "Success",
  "data": {
    "TicketId": "Reward:register:2de7d5e1-3ee6-4e43-863d-5547deb8a7a6"
  }
}

Register Referral

This API is used to initiate the reward promo process through referral during registration.

Payload Data

Name	Data Type	Description
id-user-share	Int	User ID Share
id-user-receive	Int	User ID Receive
command	String	Command Process
transaction	Object	Transaction Object
transaction.date	Datetime	Date Time Register

Response Body

Name	Data Type	Description
TicketId	String	Ticket ID Register Referral

Example Request

{
  "Subject":"loyalty",
  "SubjectType":"reward",
  "SubjectIdentifier":"processor",
  "Action":"registerreferral",
  "ResourceType":"",
  "Resource":"",
  "ResourceId":"",
  "Data":{
    "id_user_share": 462,
    "id_user_receive": 463,
    "command": "registerreferral",
    "transaction": [
      {
        "date": "2024-03-31T11:22:06"
      }
    ]
  }
}

{
  "code": 200,
  "message": "Success",
  "data": {
    "TicketId": "Reward:registerreferral:2de7d5e1-3ee6-4e43-863d-5547deb8a7a6"
  }
}

{
  "id_user_share": 462,
  "clientid": 438,
  "command": "registerreferral",
  "transaction": [
    {
      "date": "2024-05-01 10:26:11"
    }
  ]
}

Transaction Promo

This API is used to create reward promo processes through transactions.

Payload Data

Name	Data Type	Description
id	Int	ID User
command	String	Command Process
transaction	Object	Transaction Object
transaction.date	Datetime	Date Time Register
transaction.amount	Float	Transaction Amount

Response Body

Name	Data Type	Description
TicketId	String	Ticket ID Transaction Promo

Example Request

{
  "Subject":"loyalty",
  "SubjectType":"reward",
  "SubjectIdentifier":"processor",
  "Action":"transactionpromo",
  "ResourceType":"",
  "Resource":"",
  "ResourceId":"",
  "Data":{
    "id": 16659,
    "command": "transactionpromo",
    "transaction": [
      {
        "date": "2024-03-11T08:22:06",
        "amount": 6843
      },{
        "date": "2024-03-11T09:22:06",
        "amount": 8430
      },{
        "date": "2024-03-11T10:22:06",
        "amount": 2300
      },{
        "date": "2024-03-11T11:22:06",
        "amount": 5250
      }
    ]
  }
}

{
  "code": 200,
  "message": "Success",
  "data": {
    "TicketId": "Reward:transactionpromo:2de7d5e1-3ee6-4e43-863d-5547deb8a7a6"
  }
}

{
    "Data": [
        {
            "asset": 35,
            "value": 1,
            "promo_id": 52,
            "assetname": "Point Reddem",
            "assetcode": "PTS"
        }
    ]
}

Transaction Referral

This API is used to create reward promo processes through referral transactions.

Payload Data

Name	Data Type
id-user-share	Int	User ID Share
id-user-receive	Int	User ID Receive
command	String	Command Process
transaction	Object	Transaction Object
transaction.date	Datetime	Transaction Date
transaction.product_id	Int	Transaction Product ID

Response Body

Name	Data Type	Description
TicketId	String	Ticket ID Transaction Referral

Example Request

{
  "Subject":"loyalty",
  "SubjectType":"reward",
  "SubjectIdentifier":"processor",
  "Action":"transactionreferral",
  "ResourceType":"",
  "Resource":"",
  "ResourceId":"",
  "Data":{
    "id_user_share": 462,
    "id_user_receive": 463,
    "command": "transactionreferral",
    "transaction": [
      {
        "date": "2024-03-31T11:22:06",
        "product_id": 10
      },
      {
        "date": "2024-03-31T11:22:06",
        "product_id": 12
      }
    ]
  }
}

{
  "code": 200,
  "message": "Success",
  "data": {
    "TicketId": "Reward:transactionreferral:2de7d5e1-3ee6-4e43-863d-5547deb8a7a6"
  }
}

{
  "id_user_share": 462,
  "clientid": 438,
  "command": "transactionreferral",
  "transaction": [
    {
      "date": "2025-05-02 10:26:11",
      "amount": 1000
    },
    {
      "date": "2024-05-02 10:26:11",
      "amount": 1200
    }
  ]
}

Transaction Lucky Draw

This is API used to perform a transaction using the Lucky Draw feature.

Payload Data

Name	Data Type
id	Int	ID User
command	String	Command Process
transaction	Object	Transaction Object
transaction.date	Datetime	Date Time Register
transaction.amount	Float	Transaction Amount

Response Body

Name	Data Type	Description
TicketId	String	Ticket ID Transaction Referral

Example Request

{
  "Subject":"loyalty",
  "SubjectType":"reward",
  "SubjectIdentifier":"processor",
  "Action":"luckydraw",
  "ResourceType":"",
  "Resource":"",
  "ResourceId":"",
  "Data":{
    "id": 16659, 
    "command": "luckydraw",
    "transaction": [
    {
      "date": "2024-02-08T11:22:06",
      "amount": 1000
    }
  ]
  }
}

{
  "code": 200,
  "message": "Success",
  "data": {
    "TicketId": "Reward:luckydraw:2de7d5e1-3ee6-4e43-863d-5547deb8a7a6"
  }
}

{
    "Data": [
        {
            "asset": 35,
            "value": 1,
            "promo_id": 52,
            "assetname": "Lucky Draw",
            "assetcode": "LD"
        }
    ]
}