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
[ { "rewardId": "sample string 1", "amount": 1.0, "payoutId": "sample string 2", "eligibilityDate": "2025-09-18T12:36:12.9360279Z", "description": "sample string 3" }, { "rewardId": "sample string 1", "amount": 1.0, "payoutId": "sample string 2", "eligibilityDate": "2025-09-18T12:36:12.9360279Z", "description": "sample string 3" } ]
application/xml, text/xml
<ArrayOfupdateReward xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <updateReward> <payoutId>sample string 2</payoutId> <eligibilityDate>2025-09-18T12:36:12.9360279+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-09-18T12:36:12.9360279+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
{ "message": "sample string 1", "reward": { "id": "465130ac-4e67-4370-be00-990892037f4e", "payoutId": "6a64b108-9f0b-4a7e-a149-f55d07450d00", "payoutDescription": "sample string 3", "programId": "7ad4a9fe-68d2-4fbd-90ea-5045cd162c14", "programName": "sample string 5", "memberId": "d54b6ebd-c023-4863-b085-985b048ac995", "referralId": "ca34b03a-5fe2-4932-a802-9d6bb1a9baaa", "type": "sample string 6", "recipientId": "8a8a19b1-d8d7-41b2-aeeb-40fe2245ce13", "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-09-18T12:36:13.2016642Z", "issueDate": "2025-09-18T12:36:13.2016642Z", "eligibilityDate": "2025-09-18T12:36:13.2016642Z", "description": "sample string 15", "transactionID": "2cf12262-8acf-4090-8d33-4936e3bc01b9", "updateDate": "2025-09-18T12:36:13.2016642Z", "referralDisplayName": "sample string 17", "currencyCode": "sample string 18", "source": "sample string 19", "programRewardRuleId": "530b5333-b45c-4a1f-9c9b-03d84c03bdaa", "paymentType": "sample string 20", "paymentCode": "sample string 21", "completeNote": "sample string 22", "reason": "sample string 23", "reasonOther": "sample string 24" } }
application/xml, text/xml
<rewardConfirmation xmlns:i="http://www.w3.org/2001/XMLSchema-instance"> <message>sample string 1</message> <reward> <id>465130ac-4e67-4370-be00-990892037f4e</id> <payoutId>6a64b108-9f0b-4a7e-a149-f55d07450d00</payoutId> <payoutDescription>sample string 3</payoutDescription> <programId>7ad4a9fe-68d2-4fbd-90ea-5045cd162c14</programId> <programName>sample string 5</programName> <memberId>d54b6ebd-c023-4863-b085-985b048ac995</memberId> <referralId>ca34b03a-5fe2-4932-a802-9d6bb1a9baaa</referralId> <type>sample string 6</type> <recipientId>8a8a19b1-d8d7-41b2-aeeb-40fe2245ce13</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-09-18T12:36:13.2016642+00:00</createDate> <issueDate>2025-09-18T12:36:13.2016642+00:00</issueDate> <eligibilityDate>2025-09-18T12:36:13.2016642+00:00</eligibilityDate> <description>sample string 15</description> <transactionID>2cf12262-8acf-4090-8d33-4936e3bc01b9</transactionID> <updateDate>2025-09-18T12:36:13.2016642+00:00</updateDate> <referralDisplayName>sample string 17</referralDisplayName> <currencyCode>sample string 18</currencyCode> <source>sample string 19</source> <programRewardRuleId>530b5333-b45c-4a1f-9c9b-03d84c03bdaa</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>