Notifications
Ikawaari inclut des notifications visibles côté marchand pour l’activité opérationnelle à travers les paiements, les payouts, le billing et les événements de compte associés.
Routes marchandes implémentées
Les routes de notifications actuelles incluent :
GET /api/v1/merchant/notificationsPOST /api/v1/merchant/notifications/{id}/readGET /api/v1/merchant/settings/alertsPATCH /api/v1/merchant/settings/alerts
Des chemins marchands compatibles hérités peuvent aussi être disponibles sous api/merchant/*.
Ce que couvrent les notifications
Les notifications marchandes doivent être traitées comme une boîte de réception opérationnelle pour :
- les changements d’état de paiement
- les changements d’état de payout
- les actions de compte ou d’onboarding
- les alertes d’applications et d’intégrations
- les rappels de configuration marchande
Lister les notifications
GET /api/v1/merchant/notifications?limit=25&cursor=...
| Paramètre | Type | Description |
|---|---|---|
limit | integer | Nombre maximal de notifications à retourner |
cursor | string | Curseur pour la récupération incrémentale |
Marquer une notification comme lue
POST /api/v1/merchant/notifications/{id}/read
Utilisez cette opération pour réconcilier le centre de notifications marchand avec les actions utilisateur dans le dashboard.
Paramètres d’alerte
Les paramètres d’alerte sont liés mais distincts des éléments de notification. Ils contrôlent les préférences d’alerte du marchand et doivent être documentés avec la surface des paramètres.
Note de documentation
Cette page documente la surface de notification opérationnelle marchande, et non la livraison générique de webhooks ou les abonnements publics aux événements API.