Notification Service

service

Delivers invoice and payment notifications over email and webhooks.

Owner: Growth Platform
Technology: Python
Runtime: Python 3.12
Surface: 4 endpoints · 2 events

kimtu/messagingdocs/overview.md77b1e0alast commit 2 days ago by @dlin

Written by the team in docs/overview.md · rendered by Kimtu, ownership and connections below are generated

Overview

Notification Service turns billing events into customer-facing messages. It owns templates, delivery retries and suppression lists.

Responsibilities

Subscribes to invoice and payment events
Renders templates and delivers over email and webhooks
Retries failed deliveries with exponential backoff

This repository has no mkdocs.yml, so pages are ordered by folder structure.

Connections

Invoicing Job Event Bus

Notification Service

Customer WebhooksEmail ProviderRedis · queue

UpstreamNotification ServiceDownstream

Invoicing JobCalled by

POST /v1/notify · InvoiceDocument

Customer WebhooksCalls

https · WebhookDelivery

Email ProviderCalls

POST /v3/mail/send · EmailMessage

Event BusConsumes

amqp · invoice.created, payment.failed

Redis · queueCalls

redis · DeliveryTask

Component	Direction	Contract
Invoicing Job	Called by	POST /v1/notify · InvoiceDocument
Customer Webhooks	Calls	https · WebhookDelivery
Email Provider	Calls	POST /v3/mail/send · EmailMessage
Event Bus	Consumes	amqp · invoice.created, payment.failed
Redis · queue	Calls	redis · DeliveryTask

See the whole system·This neighbourhood on the system map

Published events

events/notification.sent.json

1{
2  "type": "notification.sent",
3  "version": 1,
4  "data": {
5    "notification": "ntf_1a09",
6    "channel": "email",
7    "template": "invoice_created",
8    "customer": "cus_8f21"
9  }
10}

Technology

PythonRedisRabbitMQ

Notification Service

Overview

Responsibilities

Connections

Published events

Technology

Related documentation