Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

for a specific account identified by AccountId or retrieve statement information for all accounts that the PSU customer has consented to.

This resource description should be read in conjunction with a compatible Account Information Services API Profile.

...

S.No.

Resource

HTTP Operation

Endpoint

Mandatory

Scope

Grant Type

Idempotency Key

Parameter

Request Object

Response Object

2.1

statements

GET

GET /accounts/{AccountId}/statements

Conditional

accounts

Authorization Authorisation Code

No

Pagination Filtering

 

OBReadStatement

2.2

statements

GET

GET /accounts/{AccountId}/statements/{StatementId}

Conditional

accounts

Authorization Authorisation Code

No

 

 

OBReadStatement

2.3

statements

GET

GET /accounts/{AccountId}/statements/{StatementId}/file

Optional

accounts

Authorization Authorisation Code

No

 

 

File

2.4

transactions

GET

GET /accounts/{AccountId}/statements/{StatementId}/transactions

 

Conditional

accounts

Authorization Authorisation Code

No

Pagination

 

OBReadTransaction

2.5

statements

GET

GET /statements

Optional

accounts

Authorization Authorisation Code

No

Pagination Filtering

 

OBReadStatement

...

An ASPSP may provide this endpoint for AISPs to retrieve transactions that appear on the selected statement. The data model for the returned objects is documented in the transactions resource.

2.5.      GET /statements

An ASPSP may provide this endpoint for AISPs to retrieve statement information for all accounts that the PSU customer has consented to. This will retrieve the statement resources for all authorised accounts linked to the account-request.

3.      Data Models

3.1.      OBReadStatement

...

Name

Occurrence

Enhanced Definition

Class

fromStatementDateTime

0..1

Specifies start date and time for filtering of the Statements on the Statement/StartDateTime field. If this is not populated, the start date will be open ended

DateTime

fromStatementDateTimetoStatementDateTime

0..1

Specifies start end date and time for filtering of the Statements on the Statement/StartDateTime field. If this is not populated, the start end date will be open ended

DateTime

...

  • The ReadTransactionsBasic or ReadTransactionsDetail (in addition to the appropriate ReadTransactionsCredits and/or ReadTransactionsDebits ) permission codes will be required. The ASPSP must apply the same access to GET /accounts/{AccountId}/statements/{StatementId}/transactions as GET /accounts/{AccountId}/transactions

  • If the ReadPAN permission is granted by the PSU customer - the ASPSP may choose to populate the unmasked PAN - if the PAN is being populated in the response for these fields

    • OBReadTransaction/Data/Transaction/CreditorAgent/Identification

    • OBReadTransaction/Data/Transaction/DebtorAccount/Identification

    • OBReadTransaction /Data/Transaction/CardInstrument/Identification

...

4.1.1        Get Statements Request

GET /statements

AuthorizationAuthorisation: Bearer 4ZopnFZFKjr5zDsicSQpLL

x-fapi-auth-date: Tue, 18 Mar 2020 19:43:31 GMT+03:00

x-fapi-customer-ip-address: 204.35.213.15

x-fapi-interaction-id: 75bdc714-b2dg-7676-c759-780d6815689f

Accept: application/json

...

{

  "Data": {

    "Statement": [

      {

        "AccountId": "00345897",

        "StatementId": "97813",

        "StatementReference": "005",

        "Type": "RegularPeriodic",

        "StartDateTime": "2020-03-27T09:24:04.952Z"952+03:00”,

        "EndDateTime": "2020-04-27T09:24:04.952Z"952+03:00”,

        "CreationDateTime": "2020-03-27T09:24:04.952Z"952+03:00”,

        "StatementDescription": [

          "March 2020 Statement" , "Bill Payment" ],

        "StatementFee": [

          {

            "Description": "Bill Payment",

            "CreditDebitIndicator": "Debit",

            "Type": "Bill Payment",

            "Frequency": "Monthly",

            "Amount": {

              "Amount": "1000",

                            "Currency": "BHD"

            }

          }

        ],

        "StatementAmount": [

          {

            "CreditDebitIndicator": "Debit",

            "Type": "ClosingBalance",

            "Amount": {

              "Amount": "1000",

              "Currency": "BHD" }

          },

          {

            "CreditDebitIndicator": "Credit",

            "Type": "PreviousClosingBalance",

                        "Amount": {

              "Amount": "1000",

              "Currency": "BHD"

            }

                    }

          },

          {

        "AccountId": "00125865",

        "StatementId": "17873",

        "StatementReference": "008",

        "Type": "RegularPeriodic",

        "StartDateTime": "2020-03-27T09:24:04.952Z"952+03:00”,

        "EndDateTime": "2020-04-27T09:24:04.952Z"952+03:00”,

        "CreationDateTime": "2020-03-27T09:24:04.952Z"952+03:00”,

        "StatementDescription": [

          "March 2020 Statement" , "Food expense"

        ],

      

        "StatementAmount": [

          {

            "CreditDebitIndicator": "Debit",

            "Type": "ClosingBalance",

            "Amount": {

              "Amount": "200",

              "Currency": "BHD"

            }

          },

       

          }

        ]

      }

    ]

  },"Links": {

    "Self": "www.TBC.com"

  },

  "Meta": {

    "TotalPages": 0201,

    "FirstAvailableDateTime": "2020-03-27T09:10:17.596Z596+03:00",

    "LastAvailableDateTime": "2020-03-27T09:10:17.596Z596+03:00"

  }

}

4.2.       Specific Account

...

GET /accounts/00345897/statements

AuthorizationAuthorisation: Bearer 4ZopnFZFKjr5zDsicSQpLL

x-fapi-auth-date: Tue, 18 Mar 2020 19:43:31 GMT+03:00

x-fapi-customer-ip-address: 204.35.213.15

x-fapi-interaction-id: 75bdc714-b2dg-7676-c759-780d6815689f

Accept: application/json

...

{

  "Data": {

    "Statement": [

      {

        "AccountId": "00345897",

        "StatementId": "97813",

        "StatementReference": "005",

        "Type": "RegularPeriodic",

        "StartDateTime": "2020-03-27T09:24:04.952Z"952+03:00”,

        "EndDateTime": "2020-04-27T09:24:04.952Z"952+03:00”,

        "CreationDateTime": "2020-03-27T09:24:04.952Z"952+03:00”,

        "StatementDescription": [

          "March 2020 Statement" , "Bill Payment"

        ],

        "StatementFee": [

          {

                        "Description": "Bill Payment",

            "CreditDebitIndicator": "Debit",

            "Type": "Bill Payment",

            "Frequency": "Monthly",

            "Amount": {

              "Amount": "1000",

              "Currency": "BHD"

            }

          }

        ],

        "StatementAmount": [

          {

            "CreditDebitIndicator": "Debit",

            "Type": "ClosingBalance",

            "Amount": {

              "Amount": "1000",

              "Currency": "BHD"

            }

          }

        ],

        "StatementDateTime": [

          {

            "DateTime": "2020-03-27T09:24:04.952Z"952+03:00”,

            "Type": "ClosingBalance"

          }

        ],

      }

    ]

  },

  "Links": {

    "Self": "www.TBC.com"

  },

  "Meta": {

    "TotalPages": 02,

    "FirstAvailableDateTime": "2020-03-27T09:10:17.596Z"596+03:00”,

    "LastAvailableDateTime": "2020-03-27T09:10:17.596Z"596+03:00”

  }

}