Notifications and webhooks
Hear about payments in Slack, Discord or the bell, by email where the site has it set up, or send signed events to your own server.
Notifications
In Settings, an admin or the owner adds a channel, up to ten a workspace:
- Slack: in Slack, add the Incoming Webhooks app to a channel and paste its address (
https://hooks.slack.com/services/…). - Discord: in the server settings, Integrations, Webhooks, create one and paste its address (
https://discord.com/api/webhooks/…). - Email, where the site has email sending set up: Memoline sends a confirmation link; the address receives nothing until the link is opened. Where it is not set up, Settings says so.
Each channel chooses what it hears about: a payment arrives on a link, a link is paid in full, a refund is confirmed, a payout finishes, an import finishes, a payout needs approval, an invoice becomes overdue, a schedule has made a payout that is ready to check and sign, and a schedule pauses itself. Use "Send a test" to check a channel.
Two notices reach every channel whatever events the channel chose: a payment from a wallet on a sanctions list (the US Treasury’s sanctions list (OFAC), the UK Sanctions List and the EU’s financial sanctions list), and a split link that cannot be paid because a wallet it pays is on one. Each names the list or lists. Each is sent once. See Getting paid for what they mean.
The bell
The bell at the top of every page lists the same events. Opening it marks them as seen for you.
Webhooks
Webhooks send a signed JSON event to your server for every event. An admin or the owner adds up to five endpoints. Check the Memoline-Signature header (HMAC-SHA256 of the timestamp and the body with your secret) and ignore a repeated Memoline-Delivery id. A failed delivery is tried again with growing waits, up to 12 tries.
A payment.received event says how the wallet that paid read against the three sanctions lists when the payment was recorded, in payment.payerScreen: listed when any of them names it, clear when all three were read in the last 7 days and none names it, or not-read when a list had not been read in the last 7 days. payment.payerLists names the lists that named a listed wallet (ofac, uk, eu). They are fields of the payment, not events of their own, and a later answer for a not-read payment is not sent as a webhook: the link’s page and the notifications show it.
While "A second person confirms changes" is on, a new channel or endpoint is sent nothing until another admin confirms it.