Delivery Factory
HomeDesignAdmin
Checkbook request  
Solution document · reviewed
Create the solution design from the agreed solution document.
  Solution design prepared
The solution design is ready, including the architecture, API contracts and UML sequence.
Checkbook request · Solution designArchitecture · API specifications · UML
Opened in the right panel

Use @ to mention project documents, / to use skills

  Add documentsSolution Architect
  Solution design

Architecture & data flows

01   Service architecture & data flows

External / Third-partyCore Banking (core) Backbase Banking OS Custom Banking Servicescheckbook-request-integration-service Banking ServicesAccess ControlArrangement Manager Foundation ServicesAuditEdge eligibility requestcheckbook order request eligibility / order response permission checkpermission decision arrangement lookupcore accountId audit eventeligibility / order response arrangementId + request

02   API specifications

checkbook-request-client-api.yaml · OpenAPI contract · v1

GET /client-api/v1/accounts/{arrangementId}/checkbook-eligibility

Resolve the account and check eligibility, fees and the registered mailing address.

Path parameterarrangementId · Selected customer account
ResponseEligibility · Fees / terms · Registered mailing address
POST /client-api/v1/accounts/{arrangementId}/checkbook-requests
RequestAccount reference · Checkbook options · Delivery details
Success201 Created · Order confirmation · Idempotent replay
Errors409 Conflict · Core timeout / upstream error

03   UML sequence — Create checkbook request

Permission check → account resolution → core order → audit → response.

Web / Mobile UIWeb / Mobile UIEdgeEdgeIntegration serviceIntegration serviceArrangement MgrArrangement MgrAccess ControlAccess ControlCore BankingCore BankingAuditAudit 1. POST checkbook-requests2. Forward request3. Permission check4. Permission decision5. Resolve arrangementId6. Arrangement details + core accountId7. Create checkbook request alt[201 Created / 200 OK — idempotent replay] 8. Checkbook order confirmation9. Create audit event10. Audit acknowledgement11. CheckbookRequestResponse [409 REQUEST_ALREADY_EXISTS]409 Conflict[core timeout / 5xx]502 / 503 gateway error