> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.getkard.com/legacy/api/webhooks/payment-notification/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.getkard.com/_mcp/server.

# Earned Reward Webhook

POST 

This is an outbound webhook for issuers to receive notifications from Kard on transactions that earn rewards. Learn more about how to configure, ingest and trigger your earned reward webhooks [here](https://github.com/kard-financial/kard-postman#d-trigger-an-earned-reward-webhook).

Reference: https://docs.getkard.com/legacy/api/webhooks/payment-notification

## Request

### Payload

- `user` (User, required) — Information about user that is earning reward
- `card` (Card, required) — Information about card associated with transaction that is earning reward
- `reward` (Reward, required) — Information about reward earned
- `transaction` (Transaction, required) — Information about transaction that is earning reward
- `postDineInLinkURL` (string, optional) — Post Dine In Survey Link URL, if available. This will be present for rewards associated with local offers
- `error` (string, optional, deprecated) — Error, if available

## Types

### User

- `referringPartnerUserId` (string, required) — Referring partner user ID of user from issuer

### Card

- `bin` (string, required) — Card Bank identification number (BIN)
- `last4` (string, required) — Card last four digits
- `network` (enum, required) — Name of card network
  - Allowed values: `VISA`, `MASTERCARD`, `AMERICAN EXPRESS`, `DISCOVER`

### Reward

- `merchantId` (string, required) — Merchant ID in Kard's system associated to reward
- `name` (string, required) — Merchant Name
- `commissionToIssuer` (integer, required) — Commission going to issuer and user summed up in cents
- `commissionSplit` (CommissionSplit, required) — Split of commission going to issuer and user in cents
- `status` (string, required) — Status of reward. Note, this will always be **“APPROVED"**
- `type` (string, required) — Type of reward. Note, this will always be **“CARDLINKED”**

### Transaction

- `issuerTransactionId` (string, required) — Transaction ID provided by issuer
- `status` (string, required) — Status of transaction. Note, this will either be **“APPROVED”** or **“SETTLED”**
- `transactionAmountInCents` (integer, required) — Transaction amount in cents
- `transactionTimeStamp` (string, required) — Time of transaction

### CommissionSplit

- `issuersCommissionInCents` (integer, required) — Issuer's Commission In Cents
- `usersCommissionInCents` (integer, required) — User's Commission In Cents