Simulate Test Notification

Sends a simulated earned-reward notification to the issuer’s configured webhook for the given event, without requiring a real transaction. Provide the userId and transactionId to include in the simulated transaction; offer information is sourced from an existing offer in sandbox, so the payload matches a production notification and is HMAC-signed like any other.

A fresh eventId is generated on each call, so the triggered notification is listable and replayable just like a real one. Returns 409 when the issuer has no enabled subscription for the requested event.

Sandbox environment only. This endpoint is available only in Kard’s test (sandbox) environment. It does not exist in production.
Required scopes: notifications:write

Sends a simulated earned-reward notification to the issuer's configured webhook for the given event, without requiring a real transaction. Provide the `userId` and `transactionId` to include in the simulated transaction; offer information is sourced from an existing offer in sandbox, so the payload matches a production notification and is HMAC-signed like any other. A fresh `eventId` is generated on each call, so the triggered notification is listable and replayable just like a real one. Returns `409` when the issuer has no enabled subscription for the requested event. Sandbox environment only. This endpoint is available only in Kard's test (sandbox) environment. It does not exist in production. Required scopes: `notifications:write`

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

organizationIdstringRequired

Your issuer organization ID, provided by Kard

Request

This endpoint expects an object.

datalist of objectsRequired

Response

This endpoint returns an object.

dataobject

Errors

400

Invalid Request

401

Unauthorized Error

409

Conflict Error

429

Too Many Requests Error

500

Internal Server Error

Sandbox environment only. This endpoint is available only in Kard’s test (sandbox) environment. It does not exist in production.
Required scopes: notifications:write

$	curl -X POST https://rewards-api.getkard.com/v2/issuers/organization-123/notifications \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"data": [
>	{
>	"type": "simulateTestTransaction",
>	"attributes": {
>	"userId": "issuer-user-123",
>	"transactionId": "network-txn-9f8e7d6c",
>	"eventName": "earnedRewardSettled"
>	}
>	}
>	]
>	}'