POST api/rewards/update

Updates rewards from a referral program.

Request Information

URI Parameters

Query String:

None.

Body Parameters

A list of required structures containing the details of the reward to update.

Type: Collection of UpdateReward

Name	Description	Type	Additional information
rewardId	The unique ID of a reward to update.	string	Required
amount	The value of the reward. Optional.	decimal number	None.
payoutId	The ID of the payout of which the reward will be based on.	string	Required
eligibilityDate	Date on which the recipient would be eligible to recieve the reward. Optional.	date	None.
description	A text field to provide additional information about the reward. Optional.	string	None.

Request Formats

application/json, text/json

Sample:

[
  {
    "rewardId": "sample string 1",
    "amount": 1.0,
    "payoutId": "sample string 2",
    "eligibilityDate": "2025-11-03T10:22:05.5960012Z",
    "description": "sample string 3"
  },
  {
    "rewardId": "sample string 1",
    "amount": 1.0,
    "payoutId": "sample string 2",
    "eligibilityDate": "2025-11-03T10:22:05.5960012Z",
    "description": "sample string 3"
  }
]

application/xml, text/xml

Sample:

<ArrayOfupdateReward xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <updateReward>
    <payoutId>sample string 2</payoutId>
    <eligibilityDate>2025-11-03T10:22:05.5960012+00:00</eligibilityDate>
    <description>sample string 3</description>
    <rewardId>sample string 1</rewardId>
    <amount>1</amount>
  </updateReward>
  <updateReward>
    <payoutId>sample string 2</payoutId>
    <eligibilityDate>2025-11-03T10:22:05.5960012+00:00</eligibilityDate>
    <description>sample string 3</description>
    <rewardId>sample string 1</rewardId>
    <amount>1</amount>
  </updateReward>
</ArrayOfupdateReward>

Response Information

Resource Description

[HTTP Status 200 - OK]

Type: RewardConfirmation

Name	Description	Type	Additional information
reward	Structure containing details about a reward	Reward	None.
message	The message provides more information about the results of the client's request. Review this field for error information.	string	None.

Response Formats

application/json, text/json

Sample:

{
  "message": "sample string 1",
  "reward": {
    "id": "cef505ed-1268-423e-85cc-fb68ddf8523b",
    "payoutId": "dfd9396d-cd9d-4af0-8117-092240d6ed66",
    "payoutDescription": "sample string 3",
    "programId": "667c1bc4-3156-4615-ada8-76e295973ba2",
    "programName": "sample string 5",
    "memberId": "140235c3-6b59-424e-8c3d-df3e7ac31679",
    "referralId": "4cc32d2c-a8a3-445c-b5b8-de8ae03fd110",
    "type": "sample string 6",
    "recipientId": "ce74b53e-6160-408a-b339-e54405c12bba",
    "recipientName": "sample string 7",
    "recipientEmailAddress": "sample string 8",
    "recipientExternalIdentifier": "sample string 9",
    "externalIdentifier": "sample string 10",
    "status": "sample string 11",
    "amount": 12.0,
    "createDate": "2025-11-03T10:22:05.6116309Z",
    "issueDate": "2025-11-03T10:22:05.6116309Z",
    "eligibilityDate": "2025-11-03T10:22:05.6116309Z",
    "description": "sample string 15",
    "transactionID": "29358156-f76d-49c3-b54a-eb0d283bc5f0",
    "updateDate": "2025-11-03T10:22:05.6116309Z",
    "referralDisplayName": "sample string 17",
    "currencyCode": "sample string 18",
    "source": "sample string 19",
    "programRewardRuleId": "7d7257a4-7d5c-41ac-8113-b890faeccb5b",
    "paymentType": "sample string 20",
    "paymentCode": "sample string 21",
    "completeNote": "sample string 22",
    "reason": "sample string 23",
    "reasonOther": "sample string 24"
  }
}

application/xml, text/xml

Sample:

<rewardConfirmation xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <message>sample string 1</message>
  <reward>
    <id>cef505ed-1268-423e-85cc-fb68ddf8523b</id>
    <payoutId>dfd9396d-cd9d-4af0-8117-092240d6ed66</payoutId>
    <payoutDescription>sample string 3</payoutDescription>
    <programId>667c1bc4-3156-4615-ada8-76e295973ba2</programId>
    <programName>sample string 5</programName>
    <memberId>140235c3-6b59-424e-8c3d-df3e7ac31679</memberId>
    <referralId>4cc32d2c-a8a3-445c-b5b8-de8ae03fd110</referralId>
    <type>sample string 6</type>
    <recipientId>ce74b53e-6160-408a-b339-e54405c12bba</recipientId>
    <recipientName>sample string 7</recipientName>
    <recipientEmailAddress>sample string 8</recipientEmailAddress>
    <recipientExternalIdentifier>sample string 9</recipientExternalIdentifier>
    <externalIdentifier>sample string 10</externalIdentifier>
    <status>sample string 11</status>
    <amount>12</amount>
    <createDate>2025-11-03T10:22:05.6116309+00:00</createDate>
    <issueDate>2025-11-03T10:22:05.6116309+00:00</issueDate>
    <eligibilityDate>2025-11-03T10:22:05.6116309+00:00</eligibilityDate>
    <description>sample string 15</description>
    <transactionID>29358156-f76d-49c3-b54a-eb0d283bc5f0</transactionID>
    <updateDate>2025-11-03T10:22:05.6116309+00:00</updateDate>
    <referralDisplayName>sample string 17</referralDisplayName>
    <currencyCode>sample string 18</currencyCode>
    <source>sample string 19</source>
    <programRewardRuleId>7d7257a4-7d5c-41ac-8113-b890faeccb5b</programRewardRuleId>
    <paymentType>sample string 20</paymentType>
    <paymentCode>sample string 21</paymentCode>
    <completeNote>sample string 22</completeNote>
    <reason>sample string 23</reason>
    <reasonOther>sample string 24</reasonOther>
  </reward>
</rewardConfirmation>