Generate Notification

📲 Generate Notification Request API – Overview

The Generate Notification Request API initiates a secure, real-time approval request for any enterprise transaction (such as login, money movement, or reward redemption) using REL-ID's trusted notification flow.

Once triggered:

  • A unique message ID is submitted by the enterprise.
  • REL-ID generates a notification, which is securely sent to the user’s registered iOS or Android device.
  • The user receives a push notification, opens it in the REL-ID app, and can approve or reject the transaction.
  • Based on the user’s action, the enterprise can poll for status or receive a callback.

🔐 Key Capabilities

📝 Custom Messaging

Define both:

  • notification_msg — lightweight tray message via FCM/APNS (avoid sensitive content)
  • msg — full transactional message shown securely inside the app

🔘 Configurable User Actions

  • Choose any number of actions, like Approve/Reject or Accept/Decline/Fraud
  • Set authlevel per action:
    • 0: No auth
    • 1: Password
    • 3: Device LDA
    • 4: Server Biometric

🆔 Unique Notification ID

  • API returns a notification_uuid to:
    • Poll for status (getRVNStatus)
    • Receive a callback with user response

🚫 User Eligibility Check

  • API returns an error if the user is not:
    • Registered
    • Active in the REL-ID system

Use this API to ensure that your transactions are approved by the correct user on the correct device, with a verifiable and auditable flow.