Case Lifecycle

Learn the full case lifecycle in the Banking Circle system - from creation to closure. This page shows how cases are opened by you or by Banking Circle, the key interactions and actions involved, and how webhooks keep you updated on status changes in real time.

Every case, regardless of its specific type, follows a standardized workflow with three key phases:

Case Initiation: A case is opened either by Banking Circle for your attention or by you for Banking Circle's review.
Case Management: The receiving party examines the case details and performs necessary actions. Depending on the case complexity and type, this phase may involve multiple interactions and steps.
Case Closure: Following the case's progression, through a transition of various states, it will eventually be closed. Once resolved, the case is permanently closed. No additional actions can be taken on closed cases.

The two sections below illustrates the general lifecycle of a case.

Case Created by You

sequenceDiagram
    participant BC as Banking Circle
    participant You as You

    You->>BC: Create Case
    BC-->>You: Return Case ID
    
    loop Case-type-specific interactions
        alt You perform action
            You->>BC: Perform action related to Case
            BC-->>You: Provide response or updated case information
        else Banking Circle performs action
            BC->>You: Perform action related to Case
            You-->>BC: Provide response or updated case information
        end
    end

    BC-->>You: Send webhook case-event (Case Closed)

Case Created by Banking Circle

sequenceDiagram
    participant BC as Banking Circle
    participant You as You

    BC->>BC: Create Case
    alt You uses webhook data
        BC-->>You: Send webhook case-event (Case Opened)
        You->>You: Extract Case ID <br> from webhook
    else You requests cases
        You->>BC: GET Cases (/api/v1/cases)
        BC-->>You: Return case list (including new Case ID)
    end

    loop Case-type-specific interactions
        alt You perform action
            You->>BC: Perform action related to Case
            BC-->>You: Provide response or updated case information
        else Banking Circle performs action
            BC->>You: Perform action related to Case
            You-->>BC: Provide response or updated case information
        end
    end

    BC-->>You: Send webhook case-event (Case Closed)

Webhooks

If you want to get realtime notifications on case updates you can subscribe to the CaseEvents notification.

Checksum: omCWli/jqujrbchOIEw18Zkb9hcoJvPtGxMeCd4DvfA=,
Nonce: A/zhOsBsRB/zIf6y, AuthenticationTag: Oe0P37s3DqHROlsvQ8UpDA==
SubscriptionVersion: 1
{
  "notifications": [
      {
        "subscriptionId": "8dc3cbdd-68f4-4bf5-95bb-1817d38324c7",
        "subscriptionEventId": "1d02c704-c45a-42c8-8340-ebd1426d1f03",
        "eventId": "0187f147-6587-4e30-9642-0ad9e1236474",
        "notificationType": "CasesEvents",
        "timestamp": "2025-12-08T10:50:49.9866667Z",
        "payment": 
        {
	  "eventType": "CASE_CREATED", //CASE_CLOSED
          "caseId": "2dc3cbdd-68f4-4bf5-95bb-1817d38324c7",
          "caseType": "RFI",
          "status": "OPEN", //CLOSED
          "deadline": "2025-12-03T14:23:05.5826095Z",
          "links": {
            "self": "/api/v1/cases/rfi/2dc3cbdd-68f4-4bf5-95bb-1817d38324c7"
          }
        }
      }
  ]
}

Updated 4 days ago