AA Flow

The AA Flow is for clients who use both Setu's Account Aggregator and Setu Insights. Once a customer's financial (FI) data is ready on the AA side, Signal IQ automatically takes over and drives everything through to insights and outputs.

This page explains what happens inside the flow, the exact notifications you will receive, and the output schemas you integrate against.

How the flow starts

1. You create an Account Aggregator consent request and redirect your customer to the consent URL. Your customer reviews and approves the request on the AA screens. See Setu's Account Aggregator consent flow for how to do this.
2. Once the AA data session starts, Signal IQ is triggered automatically for that session.
3. From that handoff point onward, Signal IQ owns the orchestration end to end - processing, progress notifications, insights generation and output coordination.

You do not need to call any Signal IQ API to start this flow. The trigger is handled on the AA flow.

What happens inside

Once the flow is triggered, Signal IQ moves through these lifecycle stages. You are kept informed at each important step via webhook (see Notifications below).

1. Consent lifecycle - consent status changes are forwarded to you.
2. Data fetch - FI data is retrieved (or its failure is reported).
3. Data block creation - the fetched data is prepared for analysis inside Setu Insights.
4. Insights generation started - the insights job is accepted.
5. Insights generation success / failure - the report is produced, or the failure is reported.
6. Report availability - the reportId is handed to you for output retrieval.

Notifications you receive

Every notification is delivered as an HTTP POST to your configured webhook URL, and is wrapped in the same envelope -

{
  "type": "AUTO_DI_STATUS",
  "data": {
    "status": "<STAGE_STATUS>"
  }
}

The data.status field tells you which stage was reached. The correlation field in this flow is consentId.

Full catalogue

Treat INSIGHTS_CREATION_SUCCESSFUL as terminal success, and FI_DATA_FETCH_FAILED, FI_DATA_BLOCK_CREATION_FAILED and INSIGHTS_CREATION_FAILED as terminal failures.

Examples of every schema

{
  "type": "AUTO_DI_STATUS",
  "data": {
    "status": "CONSENT_ACTIVE",
    "consentId": "9dee34fe-8449-4f80-914e-b9725f3585cd"
  }
}

{
  "type": "AUTO_DI_STATUS",
  "data": {
    "status": "FI_DATA_FETCH_FAILED",
    "consentId": "9dee34fe-8449-4f80-914e-b9725f3585cd",
    "errorCode": "FIP_TIMEOUT",
    "errorMessage": "Bank did not respond"
  }
}

{
  "type": "AUTO_DI_STATUS",
  "data": {
    "status": "FI_DATA_BLOCK_CREATION_SUCCESS",
    "consentId": "9dee34fe-8449-4f80-914e-b9725f3585cd",
    "dataIds": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"]
  }
}

{
  "type": "AUTO_DI_STATUS",
  "data": {
    "status": "INSIGHTS_CREATION_STARTED",
    "consentId": "9dee34fe-8449-4f80-914e-b9725f3585cd",
    "reportId": "7f3e4d5c-1111-2222-3333-444455556666",
    "datablockId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

{
  "type": "AUTO_DI_STATUS",
  "data": {
    "status": "INSIGHTS_CREATION_SUCCESSFUL",
    "consentId": "9dee34fe-8449-4f80-914e-b9725f3585cd",
    "reportId": "7f3e4d5c-1111-2222-3333-444455556666",
    "datablockId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

{
  "type": "AUTO_DI_STATUS",
  "data": {
    "status": "INSIGHTS_CREATION_FAILED",
    "consentId": "9dee34fe-8449-4f80-914e-b9725f3585cd",
    "reportId": "7f3e4d5c-1111-2222-3333-444455556666",
    "datablockId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }
}

Notifications are configurable

Step-by-step notifications can be tailored to you. A client who does not want intermediate updates can have them switched off entirely - the pipeline runs identically, just silently - or can choose to receive only specific stages. This is set up during onboarding.

Webhook delivery

When Signal IQ posts a notification to your webhook -

Getting your outputs

On INSIGHTS_CREATION_SUCCESSFUL, use the reportId from the webhook to fetch your configured outputs. See the API reference for how to fetch results.

See how Signal IQ works when your journey starts from a bank-statement PDF.