Transaction Webhook

RM sends a POST webhook to your registered notifyUrl whenever an enrolled Visa card transacts at a participating merchant. Use it to track qualifying transactions in real time.

When to Use

▾

Implement a handler for this webhook when:

• You want real-time notifications of card-linked offer events
• Awarding cashback or rewards based on qualifying transactions
• Reconciling user activity into your own ledger

important

The webhook is delivered to the notifyUrl you supplied during Enroll User. Your endpoint must respond with HTTP 200 OK to acknowledge receipt.

How to Use

▾

Step 1: Expose a Public POST Handler

▾

Build an HTTP endpoint that accepts JSON POST requests over HTTPS.

Step 2: Register the URL

▾

Pass the URL as notifyUrl when calling Enroll User.

Step 3: Verify and Acknowledge

▾

Validate the payload signature (if applicable), persist the transaction, and respond 200 OK quickly to avoid retries.

---

Request Parameters

▾

userIdSTRINGrequired

RM-issued user ID.

Example: "1693590750219574539"

cardIdSTRINGrequired

RM-issued card ID.

Example: "1693590754940319811"

transactionIdSTRINGrequired

Unique transaction ID.

Example: "1693591501957443719"

transactionAtDATETIMErequired

Transaction timestamp (ISO 8601).

Example: "2023-08-30T09:39:15"

amountINTEGERrequired

Transaction amount in cents.

Example: 1128

currencySTRINGrequired

Numeric ISO 4217 currency code.

Example: "840"

merchantCategoryCodeSTRINGrequired

Merchant Category Code (MCC).

Example: "0000"

Example Payload

▾

Example Webhook Body

JSON

1{
2"userId": "1693590750219574539",
3"cardId": "1693590754940319811",
4"transactionId": "1693591501957443719",
5"transactionAt": "2023-08-30T09:39:15",
6"amount": 1128,
7"currency": "840",
8"merchantCategoryCode": "0000"
9}