RewardCampaignService
Set My Reward Destination
Record a write-once payout destination for the authenticated recipient's award. Requires a session token. This does not execute a transfer or mark the award delivered.
Request
curl --request PUT \ \
--url 'https://api.testnet.polyester.com/v1/rewards/awards/example/destination' \
--header 'Accept: */*' \
--header 'X-API-KEY-ID: YOUR_API_KEY_ID' \
--header 'X-API-TIMESTAMP: YOUR_API_TIMESTAMP' \
--header 'X-API-SIGNATURE: YOUR_API_SIGNATURE' \
--header 'Content-Type: application/json' \
--data '{
"destinationAddress": "0x3333333333333333333333333333333333333333",
"expectedRevision": "1",
"requestId": "request_01J0EXAMPLE"
}'Responses
{
"award": {
"amountBaseUnits": "123.45",
"assetId": 100,
"awardId": "value",
"campaignId": "value",
"campaignName": "value",
"destinationAddress": "0x3333333333333333333333333333333333333333",
"fulfillmentMethod": "EXTERNAL_TESTNET",
"fulfillmentRevision": "1",
"fulfillmentState": "AWAITING_DESTINATION",
"network": "value",
"publishedAt": "2025-01-01T00:00:00Z",
"transactionId": "value"
}
}Award owned by the authenticated root account.
Destination address interpreted according to the award campaign's network.
Fulfillment revision observed by the recipient.
Client-generated idempotency identifier. Maximum 128 characters.
Stable opaque award identifier.
valueStable campaign identifier.
valueCampaign display name frozen at publication.
valueCanonical asset identifier.
100Exact integer amount in the asset's smallest base unit.
123.45Selected delivery method.
EXTERNAL_TESTNETCurrent delivery state.
AWAITING_DESTINATIONPublication time.
2025-01-01T00:00:00ZCampaign payout network. Interpret destination_address in this network.
valueCurrent fulfillment revision for optimistic concurrency.
1Recipient payout destination once submitted. Empty until provided.
0x3333333333333333333333333333333333333333External transaction identifier once staff records delivery. Empty until delivered.
value| Key | HTTP status | Connect code | Error | When |
|---|---|---|---|---|
| unauthenticated | 401 | unauthenticated | Unauthenticated | Authentication required. |
| permission-denied | 403 | permission_denied | Permission Denied | Permission denied. |
| invalid-argument | 400 | invalid_argument | Invalid Argument | Invalid argument. |
| not-found | 404 | not_found | Not Found | Not found. |
| unavailable | 503 | unavailable | Unavailable | Service unavailable. |