Guides
  1. Data Products
  2. Open Banking Accout Connection (AIS)

Consent status updates

Track consent status changes with webhook updates.

Webhook notifications

Rather than polling, Feezback pushes consent lifecycle changes to you via webhook.

Supported events:

  • ConsentStatusChanged — fired on every status transition
  • UserDataIsAvailable — fired once the initial data pull for a new consent completes.
  • UserInsightReady — insights report is ready and you can call the "insights" endpoint for this userId.
  • ConsentAboutToExpire — fired ahead of a consent's validUntil
  • ConsentNotAccessed — fired if a valid consent hasn't been used to pull data recently
  • DataRefreshComplete — a TPP-wide event when a scheduled data refresh finishes

Configure your webhook endpoint as part of onboarding — see Webhooks - Async Updates for the general mechanics (security, response requirements, troubleshooting).

Implementation Requirements

  • Implement a REST endpoint accepting POST requests
  • Return HTTP 200 status code within 3 seconds
  • Handle JSON payloads with timestamp, event, and payload fields

Consent statuses - reference table

StatusDescription
receivedconsent request is received by the bank - user was redirected to the bank for authentication and approval.
validConsent was approved, is active and can be used for data access.
terminatedByTppConsent was terminated by you.
expiredConsent has reached its validUntil date
revokedByPsuConsent was revoked by the account holder.
revokedByAspspConsent was revoked by the bank.
rejectedConsent request was rejected.
partiallyAuthorizedConsent requires additional approval from joint account holders.
failedConsent processing failed due to technical issues
noAnswerthere was no response from the bank within two weeks

Managing consent

Use these endpoints to inspect or terminate consents:

MethodEndpointPurpose
GET
/tpp/v1/users/USERID/consents
Read the user's consent list. Returns only valid consents unless withInvalid is requested.
GET
/tpp/v1/users/USERID/consents/{consentId}
Read details for a specific consent.
DELETE
/tpp/v1/users/USERID/consents/{consentId}
Terminate a specific consent by setting its status to terminatedByTpp.
DELETE
/tpp/v1/users/USERID/consents
Delete user data from the database, when allowed.

When terminating a consent, you can send the optional reason query parameter:

clientDisconnectedFromDigital
terminatedDueToTechnicalProblem
allUserAccountsWereClosed
terminatedByTpp

Updated 10 days ago

Did this page help you?