transactionReward.created

Add rewardUnit field

rewardUnit field added

Added the rewardUnit field to the transactionReward.created webhook payload. This field clarifies that rewardAmount is denominated in whole reward points, and is always points. You receive this field only if your tenant is opted in to webhook version 1.1.0 or later; earlier versions never include it.

New Field

Field	Type	Description
`body.rewardUnit`	`string`	The unit of `body.rewardAmount`. Always `points` (whole reward points).

Example Payload

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "resource": "transactionReward",
    "action": "created",
    "version": "1.1.0",
    "body": {
        "id": "txn_789xyz012abc",
        "userId": "usr_def456ghi789",
        "rewardAmount": "200",
        "rewardUnit": "points"
    },
    "eventReceivedAt": "2026-06-30T02:30:00.000Z"
}

initial release

transactionReward.created webhook

Added the transactionReward.created webhook. Rain sends this webhook after a card transaction settles and records the final reward. It carries the awarded points so you can mint the corresponding points to your end user on-chain. Rain sends it only for partner-managed on-chain tenants (PARTNER_ONCHAIN), once per card transaction. Rain does not send it for RAIN_MANAGED or PARTNER_OFFCHAIN tenants, or when a transaction earns zero points.Because the reward is final when the card transaction settles, it is terminal the moment Rain sends this webhook. Rain does not run a later step or emit any follow-up event for the reward, so mint the corresponding points to your end user as soon as you receive it.

Payload Fields

Field	Type	Description
`id`	`string`	Webhook ID
`resource`	`string`	Always `"transactionReward"`
`action`	`string`	Always `"created"`
`version`	`string`	The webhook version
`body.id`	`string`	The card transaction ID that earned the reward
`body.userId`	`string`	The ID of the user who earned the reward
`body.rewardAmount`	`string`	The awarded reward amount, in points
`eventReceivedAt`	`string` (optional)	ISO-8601 timestamp

Example Payload

{
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "resource": "transactionReward",
    "action": "created",
    "version": "1.0.0",
    "body": {
        "id": "txn_789xyz012abc",
        "userId": "usr_def456ghi789",
        "rewardAmount": "200"
    },
    "eventReceivedAt": "2026-06-30T02:30:00.000Z"
}

​rewardUnit field added

​New Field

​Example Payload

​transactionReward.created webhook

​Payload Fields

​Example Payload

rewardUnit field added

New Field

Example Payload

transactionReward.created webhook

Payload Fields

Example Payload