Notifications and reminders
RekberPay tells the people in your workspace when something on a deal needs them: a delivery to approve, money that arrived, a dispute, a message from the counterparty. Each notice lands in the bell of the dashboard, and by email for members who turned email on. On top of that, RekberPay sends reminders when work stalls.
This guide is about people. For your systems, use webhooks or the event feed, which carry every event and ignore these switches.
Your switches
Each member sets their own switches, per workspace: Settings, then Notifications, then Save notifications. Everything starts on.
| Dashboard switch | Key | Covers |
|---|---|---|
| Deals | deals | A deal shared with you or activated, a deal cancelled, and a cancel request answered or withdrawn. On a shared deal the delivery decision email follows it too, while the bell notice for an approved delivery follows Funding and payouts |
| Approvals | approvals | A delivery waiting for your approval, a fee split, a cancel request or a dispute answer from a linked workspace, and the approval reminder |
| Funding and payouts | funding | Funding, releases, payouts and refunds, including the Dispute resolved notice that announces a refund |
| Disputes | disputes | Disputes opened, answered and resolved |
| Messages | messages | A deal room message from the other workspace, at most once per deal every 30 minutes |
| Reminders | reminders | Every reminder in the table below |
| Email me as well | email | An email copy of each notice you get in the bell |
Viewers never get money notices, so they do not see Funding and payouts, Disputes and Messages. Invitations and role changes always reach you. Nobody is notified about their own action.
The same switches can be set from a dashboard session with PATCH /v1/enterprise/members/me/preferences. Send only the keys you change:
curl -X PATCH https://api.rekberpay.com/v1/enterprise/members/me/preferences \
-b cookies.txt \
-H "X-CSRF-Token: $CSRF_TOKEN" \
-H "X-Enterprise-Account: $WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{ "reminders": false, "email": true }'The answer is your full set under notify. GET /v1/enterprise/me shows the same set under membership.notify. An API key cannot change switches (403 KEY_NOT_ALLOWED), and an unknown key or a value that is not true or false answers 400 INVALID_BODY. An older money key still works: it stands in for funding and disputes when those two were never set.
The bell itself is GET /v1/enterprise/notifications (your 20 newest notices in this workspace and the unread count) and POST /v1/enterprise/notifications/read to mark them read. Both are dashboard only. See List workspace notifications for every notice type.
Automatic reminders
RekberPay checks for stalled work every hour and sends at most one reminder per item per day, so a stalled delivery gets one nudge a day until someone acts.
| Reminder | Sent when | Goes to |
|---|---|---|
| Waiting for approval | A delivery has waited more than 24 hours for a decision | Every finance, admin and owner member, except the person who delivered and anyone who already decided on it |
| Overdue | A milestone is past its due date and still waits for its funding (on a per-milestone deal) or for its delivery | The deal owner, admins and owners |
| Dispute past SLA | A dispute has been open longer than the workspace's dispute SLA (24 hours unless you changed it in Settings) | The deal owner, admins and owners |
| Due soon / Overdue on the funding deadline | An upfront deal is not funded and its deadline is less than 24 hours away, or past | The paying workspace's finance members (admins if there is none, owners if there is no admin) |
| Due soon / Overdue on a room step | On a shared deal, the next step of the deal room is due within 24 hours, or past due | The members of the side whose turn it is who can do that step |
Notes:
- On a shared deal, the room step reminders replace Overdue, so nobody gets both.
- Waiting for approval follows both the Approvals and the Reminders switch. The others follow Reminders.
- A Sandbox deal's reminders carry a Sandbox tag and only go to your own workspace, never to a linked one.
- To stop a reminder, act on the item: decide on the delivery, fund the deal, move the date or answer the dispute.
Related
- Four-eyes approvals: who can approve what.
- Share a deal with your counterparty: which emails the counterparty gets.
- Workspace reference.