Push Notifications

Register FCM (Firebase Cloud Messaging) device tokens to receive real-time push notifications for payment events, withdrawals, and alerts.

Auth required: JWT
Base path: /api/v1/auth

---

Register Device Token

POST /api/v1/auth/fcm-token
Authorization: Bearer <token>
Content-Type: application/json

{
  "token": "fcm_device_token_from_firebase_sdk",
  "platform": "android"
}

platform accepts android, ios, or web.

---

Unregister Device Token

Call when the user logs out or uninstalls the app.

DELETE /api/v1/auth/fcm-token
Authorization: Bearer <token>
Content-Type: application/json

{
  "token": "fcm_device_token_from_firebase_sdk"
}

---

Get Notification Preferences

GET /api/v1/auth/notification-preferences
Authorization: Bearer <token>

Response

{
  "payment_received": true,
  "withdrawal_processed": true,
  "kyc_status_change": true,
  "fraud_alert": true,
  "marketing": false
}

---

Update Notification Preferences

PUT /api/v1/auth/notification-preferences
Authorization: Bearer <token>
Content-Type: application/json

{
  "payment_received": true,
  "withdrawal_processed": true,
  "kyc_status_change": false,
  "marketing": false
}