Operations and Execution
Direct Debit Mandate
sd-direct-debit-mandate · bian-operations
A BIAN service domain in Operations and Execution. It applies the Manage functional pattern to the Direct Debit Mandate, with the Direct Debit Mandate Management Plan as its control record — one independent Spring Boot microservice on the platform's Cilium eBPF mesh.
View repository ↗The 162-domain platform ↗
Business DomainPayments
Functional PatternManage
Asset TypeDirect Debit Mandate
Control RecordDirect Debit Mandate Management Plan
USEWhat it is used for
Representative use cases for the Direct Debit Mandate service domain within a BIAN-aligned core-banking landscape.
- Accept, validate, and route Direct Debit Mandate instructions to the correct rail
- Execute transfers with debit/credit atomicity and compensation on failure
- Provide payment status tracking to channels and corporate clients (gpi-style)
- Screen instructions against sanctions lists before release
APIBIAN semantic API
The control record (Direct Debit Mandate Management Plan) is exposed through uniform BIAN action terms. Java 21 · Spring Boot 3, OpenAPI at /swagger-ui.html, health at /actuator/health.
| Method | Path | BIAN action |
|---|
| GET | /v1/service-domain | Service metadata |
| POST | /v1/direct-debit-mandate-management-plan/initiate | Initiate |
| GET | /v1/direct-debit-mandate-management-plan/{crId}/retrieve | Retrieve |
| PUT | /v1/direct-debit-mandate-management-plan/{crId}/update | Update |
| PUT | /v1/direct-debit-mandate-management-plan/{crId}/control | Control (suspend / resume / terminate) |
INTBackend integrations
The systems and standards a real deployment of Direct Debit Mandate would transact with.
- Rails: SWIFT, SEPA, ACH/NACHA, UPI (NPCI), NEFT/RTGS/IMPS, FedNow, TARGET2
- Payment hubs: Volante, ACI Worldwide, FIS, Finastra
- Sanctions screening: Fircosoft, LexisNexis Bridger
RUNRun it yourself
Each service domain is its own standalone Spring Boot repository — clone and run in seconds, or deploy onto Kubernetes with the bundled Helm chart behind the Cilium mesh.
# run this service domain standalone
git clone https://github.com/Sreenivas-Sadhu-Prabhakara/sd-direct-debit-mandate
mvn -f sd-direct-debit-mandate spring-boot:run
curl localhost:8080/v1/service-domain
# or deploy onto Kubernetes (Cilium eBPF mesh)
helm upgrade --install sd-direct-debit-mandate ./helm -n bian-operations
FAQQuestions
What is the BIAN “Manage” functional pattern?
A Manage service domain plans, coordinates and oversees a resource or activity across its lifecycle. Direct Debit Mandate applies it to the Direct Debit Mandate.
What is a BIAN service domain?
BIAN (the Banking Industry Architecture Network) decomposes a bank into independent service domains, each owning exactly one business capability. Direct Debit Mandate is the service domain for Payments; it manages the Direct Debit Mandate Management Plan and exposes it through standard BIAN action terms.
What business area does Direct Debit Mandate belong to?
Direct Debit Mandate sits in the Operations and Execution business area — the operational core that executes payments, positions, settlements and transactions. It runs in the bian-operations namespace as one independent Spring Boot microservice.
Is Direct Debit Mandate production-ready?
It is an educational reference implementation: a real BIAN REST API over an in-memory store, ready to be filled with domain logic. It is not a live bank and is not affiliated with BIAN.
SEEIn the landscape
Direct Debit Mandate is one of 162 BIAN service domains on the platform. Explore the rest: