For the complete documentation index, see llms.txt. This page is also available as Markdown.

SLA Notification Payload

SNA also pushes a Notification metrics payload to the Sahamati endpoint every 10 minutes. This payload captures incoming notification traffic from FIPs to the AA, including notification counts and FI notification status breakdowns. The tag for this payload is not-fipMetrics-aa.

Schema Reference

Field
Type
Description

agentVersion

string

Version of the SNA agent generating this payload

jsonVersion

string

Version of the JSON schema (e.g. "1.0.0")

tag

string

"not-fipMetrics-aa" identifies this as a notification-metrics payload from AA perspective of FIP

txnId

string

Unique transaction ID for this push request

fromDateTime

string

Start of the 10-minute reporting window (ISO 8601, UTC)

toDateTime

string

End of the 10-minute reporting window (ISO 8601, UTC)

duration

int

Duration in seconds of the reporting window (600 for 10 minutes)

aaId

string

Entity ID of the Account Aggregator

fips[].fipId

string

Entity ID of the FIP for which notification metrics are reported

fips[].metrics[].type

string

Metric type code: finot, alnot, or cnot

fips[].metrics[].counts

array[int]

Count values aligned to countFields enum in the notification payload

fips[].metrics[].status

array[int]

Status values (only for type "finot"): [succRecdCnt, failRecdCnt, readyRecdCnt, deniedRecdCnt, deliveredRecdCnt, timeoutRecdCnt, intermediateRecdCnt]

Notification Metric Types

Code
Full Name
Description

finot

fiNotificationRecd_finot

FI notifications received from FIP counts and status breakdown (READY, DELIVERED, DENIED, TIMEOUT, PENDING)

alnot

accountLinkNotificationRecd_alnot

Account link notifications received from FIP

cnot

consentNotificationRecd_cnot

Consent notifications received from FIP

Notification Count Fields

The counts array is positionally aligned to these fields:

Position
Field Name
Description

1

totalRecdCnt

Total notifications received. For FI notifications: count only the last /FI/Notification where all FIStatus states are terminal (READY, DELIVERED, DENIED, TIMEOUT).

2

200OKSentCnt

HTTP 200 OK responses sent back

3

400BadReqSentCnt

HTTP 400 Bad Request responses sent

4

401UnauthorizedReqSentCnt

HTTP 401 Unauthorized responses sent

5

403ForbiddenReqSentCnt

HTTP 403 Forbidden responses sent

6

404NotFoundSentCnt

HTTP 404 Not Found responses sent

7

409IdempotencyErrorReqSentCnt

HTTP 409 Idempotency Error responses sent

8

412PreConditionFailedSentCnt

HTTP 412 Precondition Failed responses sent

9

429TooManyReqsSentCnt

HTTP 429 Too Many Requests responses sent

10

4xxOtherErrorsSentCnt

All other 4xx error responses sent

11

500InternalServerErrorSentCnt

HTTP 500 Internal Server Error responses sent

12

502BadGatewaySentCnt

HTTP 502 Bad Gateway responses sent

13

503ServiceUnavailableSentCnt

HTTP 503 Service Unavailable responses sent

14

504GatewayTimeoutSentCnt

HTTP 504 Gateway Timeout responses sent

15

5xxOtherErrorsSentCnt

All other 5xx error responses sent

FI Notification Status Fields

The status array is only present for the "finot" metric type and is positionally aligned to these fields:

Position
Field Name
Description

1

succRecdCnt

Notifications with at least one READY or DELIVERED state in final /FI/Notification

2

failRecdCnt

Notifications where all accounts are DENIED or TIMEOUT (none READY or DELIVERED) does not include 4xx/5xx errors

3

readyRecdCnt

Notifications with terminal state READY in final /FI/Notification

4

deniedRecdCnt

Notifications with terminal state DENIED in final /FI/Notification

5

deliveredRecdCnt

Notifications with terminal state DELIVERED in final /FI/Notification

6

timeoutRecdCnt

Notifications with terminal state TIMEOUT in final /FI/Notification

7

intermediateRecdCnt

Notifications still in non-terminal state PENDING

📌 Time difference between FIReq 200 OK and failure notification (Note: All accounts are marked as DENIED or TIMEOUT in the final /FI/Notification, i.e., none of the states are READY.)

Last updated

Was this helpful?