Customer Service
serviceStores customer records, billing addresses and tax identifiers.
- Owner
- Accounts Team
- Technology
- TypeScript
- Runtime
- Node 20.x
- Surface
- 9 endpoints · 2 events
kimtu/accountsdocs/overview.mda71c4delast commit 6 hours ago by @jtan
Written by the team in docs/overview.md · rendered by Kimtu, ownership and connections below are generated
Overview
Customer Service is the system of record for customer identity in billing. Other services reference customers by their cus_ identifier and never copy address or tax data.
Responsibilities
- Exposes CRUD endpoints for customer records
- Validates tax identifiers against regional rules
- Emits customer.updated when billing details change
This repository has no mkdocs.yml, so pages are ordered by folder structure.
Connections
UpstreamCustomer ServiceDownstream
| Component | Direction | Contract |
|---|---|---|
| API Gateway | Called by | REST /v1/customers · Customer |
| Admin Console | Consumes | http · Customer |
| Event Bus | Calls | amqp · customer.updated |
| Postgres · customers | Calls | postgres · Customer, BillingAddress, TaxId |
| Invoice Service | Called by | GET /v1/customers/{id} · Customer |
Published events
events/customer.updated.json
1{2 "type": "customer.updated",3 "version": 2,4 "data": {5 "customer": "cus_8f21",6 "fields": ["billing_address", "tax_id"]7 }8}Technology
TypeScriptPostgreSQLRabbitMQ