Skip to content

Learn Git and GitHub without any code!

Using the Hello World guide, you’ll start a branch, write comments, and open a pull request.

Read the guide
  • Watch
    Notifications
  • Fork
Permalink
master
Go to file
1 contributor

Users who have contributed to this file

4475 lines (4383 sloc) 148 KB
swagger: '2.0'
info:
title: Account and Transaction API Specification
description: >-
Swagger for Account and Transaction API Specification. This is heavily
derived from the Open Banking UK API - see www.openbanking.org.uk for
details.
termsOfService: 'https://www.apicentre.paymentsnz.co.nz/contact-us/'
contact:
name: Payments NZ API Centre
email: apicentre@paymentsnz.co.nz
license:
name: Licence
url: 'https://www.apicentre.paymentsnz.co.nz/join/'
version: v2.0.1
basePath: /open-banking-nz/v2.0
schemes:
- https
consumes:
- application/json; charset=utf-8
produces:
- application/json; charset=utf-8
tags:
- name: Account Access Consents
description: >-
A consent to access account information resources
- name: Accounts
description: >-
A resource that represents the account to which credit and debit entries are
made
- name: Balances
description: >-
A resource that represents the net increases and decreases in an account at a
specific point in time
- name: Beneficiaries
description: >-
A set of elements that describe the list of trusted beneficiaries linked to a
specific account
- name: Direct Debits
description: >-
A set of elements that describe the list of direct-debits that have been set up
on a specific account
- name: Offers
description: >-
A set of elements that descirbe the list of offers avaialble to a specific
account
- name: Party
description: >-
A set of elements that describe the party linked to a specific account
- name: Scheduled Payments
description: >-
A set of elements that describe the list of scheduled-payments that have been
set up on a specific account
- name: Standing Orders
description: >-
A set of elements that describe the list of standing-orders that have been set
up on a specific account
- name: Statements
description: >-
A resource that describes summary details for an account statement period
- name: Transactions
description: >-
A resource that describes a posting to an account that results in an increase
or decrease to a balance
paths:
'/account-access-consents':
post:
tags:
- Account Access Consents
operationId: CreateAccountAccessConsent
summary: Create an account access consent
description: >-
The account-access-consents resource represents a consent that has been
agreed between the Customer and the Third Party for the Third Party to
access a Customer's account information with an API Provider.
parameters:
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
- name: body
in: body
description: Account Access Consent Body
required: true
schema:
title: Account Access Consent
type: object
properties:
Data:
$ref: '#/definitions/AccountAccessConsentModel'
Risk:
$ref: '#/definitions/Risk'
required:
- Data
- Risk
additionalProperties: false
responses:
'201':
description: Account Access Consent successfully created
schema:
title: Account Access Consent POST response
type: object
properties:
Data:
$ref: '#/definitions/AccountAccessConsentResponseModel'
Risk:
$ref: '#/definitions/Risk'
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Risk
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'415':
$ref: '#/responses/415ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- ThirdPartyOAuth2Security:
- accounts
'/account-access-consents/{ConsentId}':
get:
tags:
- Account Access Consents
operationId: GetAccountAccessConsent
summary: Get an account access consent
description: Retrieve an account access consent and check its status.
parameters:
- $ref: '#/parameters/ConsentIdParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Access Consent successfully retrieved
schema:
title: Account Access Consent GET response
type: object
properties:
Data:
$ref: '#/definitions/AccountAccessConsentResponseModel'
Risk:
$ref: '#/definitions/Risk'
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Risk
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- ThirdPartyOAuth2Security:
- accounts
delete:
tags:
- Account Access Consents
operationId: DeleteAccountAccessConsent
summary: Delete an account access consent
description: Delete an account access consent
parameters:
- $ref: '#/parameters/ConsentIdParam'
- $ref: '#/parameters/AuthorizationParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
responses:
'204':
description: Account Access Consent successfully deleted
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- ThirdPartyOAuth2Security:
- accounts
'/accounts':
get:
tags:
- Accounts
operationId: GetAccounts
summary: Get Accounts
description: Get a list of accounts
parameters:
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Accounts successfully retrieved
schema:
title: Account GET response
type: object
properties:
Data:
title: Data
type: object
description: Data
properties:
Account:
title: Account
description: Account
type: array
items:
$ref: '#/definitions/AccountModel'
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}':
get:
tags:
- Accounts
operationId: GetAccount
summary: Get Account
description: Get an account
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account resource successfully retrieved
schema:
title: Account GET response
type: object
properties:
Data:
title: Data
description: Data
type: object
properties:
Account:
$ref: '#/definitions/AccountModel'
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}/transactions':
get:
tags:
- Transactions
operationId: GetAccountTransactions
summary: Get Account Transactions
description: Get transactions related to an account
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/FromBookingDateTimeParam'
- $ref: '#/parameters/ToBookingDateTimeParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Transactions successfully retrieved
schema:
title: Transactions GET response
type: object
properties:
Data:
title: Data
description: Data
type: object
properties:
Transaction:
title: Transaction
description: Transaction
type: array
items:
$ref: '#/definitions/TransactionModel'
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}/beneficiaries':
get:
tags:
- Beneficiaries
operationId: GetAccountBeneficiaries
summary: Get Account Beneficiaries
description: Get Beneficiaries related to an account
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Beneficiaries successfully retrieved
schema:
title: Beneficiaries GET response
type: object
properties:
Data:
title: Data
description: Data
type: object
properties:
Beneficiary:
title: Beneficiary
description: Beneficiary
type: array
items:
$ref: '#/definitions/BeneficiaryModel'
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}/balances':
get:
tags:
- Balances
operationId: GetAccountBalances
summary: Get Account Balances
description: Get Balances related to an account
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Balances successfully retrieved
schema:
title: Balances GET response
type: object
properties:
Data:
title: Data
description: Data
type: object
properties:
Balance:
title: Balance
description: Balance
type: array
items:
$ref: '#/definitions/BalanceModel'
required:
- Balance
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}/direct-debits':
get:
tags:
- Direct Debits
operationId: GetAccountDirectDebits
summary: Get Account Direct Debits
description: Get Direct Debits related to an account
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Direct Debits successfully retrieved
schema:
title: Direct Debit GET response
type: object
properties:
Data:
title: Data
description: Data
type: object
properties:
DirectDebit:
title: DirectDebit
description: DirectDebit
type: array
items:
$ref: '#/definitions/DirectDebitModel'
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}/standing-orders':
get:
tags:
- Standing Orders
operationId: GetAccountStandingOrders
summary: Get Account Standing Orders
description: Get Standing Orders related to an account
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Standing Orders successfully retrieved
schema:
title: Standing Orders GET response
type: object
properties:
Data:
title: Data
description: Data
type: object
properties:
StandingOrder:
title: StandingOrder
description: StandingOrder
type: array
items:
$ref: '#/definitions/StandingOrderModel'
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}/offers':
get:
tags:
- Offers
operationId: GetAccountOffers
summary: Get Account Offers
description: Get Offers related to an account
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Offers successfully retrieved
schema:
type: object
properties:
Data:
type: object
properties:
Offer:
items:
$ref: '#/definitions/OfferModel'
type: array
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}/party':
get:
tags:
- Party
operationId: GetAccountParty
summary: Get Account Party
description: Get Party related to an account
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Party successfully retrieved
schema:
type: object
properties:
Data:
type: object
properties:
Party:
$ref: '#/definitions/PartyModel'
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}/scheduled-payments':
get:
tags:
- Scheduled Payments
operationId: GetAccountScheduledPayments
summary: Get Account Scheduled Payments
description: Get Scheduled Payments related to an account
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Scheduled Payment successfully retrieved
schema:
type: object
properties:
Data:
type: object
properties:
ScheduledPayment:
items:
$ref: '#/definitions/ScheduledPaymentModel'
type: array
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}/statements':
get:
tags:
- Statements
operationId: GetAccountStatements
summary: Get Account Statements
description: Get Statements related to an account
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/FromStatementDateTimeParam'
- $ref: '#/parameters/ToStatementDateTimeParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Statement successfully retrieved
schema:
type: object
properties:
Data:
type: object
properties:
Statement:
items:
$ref: '#/definitions/StatementModel'
type: array
description: Provides further details on a statement resource.
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}/statements/{StatementId}':
get:
tags:
- Statements
operationId: GetAccountStatement
summary: Get Statement
description: Get Statement related to an account
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/StatementIdParam'
- $ref: '#/parameters/FromStatementDateTimeParam'
- $ref: '#/parameters/ToStatementDateTimeParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Statement successfully retrieved
schema:
type: object
properties:
Data:
type: object
properties:
Statement:
$ref: '#/definitions/StatementModel'
description: Provides further details on a statement resource.
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}/statements/{StatementId}/file':
get:
tags:
- Statements
operationId: GetAccountStatementFile
summary: Get Statement File
description: Get Statement related to an account
produces:
- '*/*'
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/StatementIdParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Statement File successfully retrieved
schema:
type: file
description: Statement File
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/accounts/{AccountId}/statements/{StatementId}/transactions':
get:
tags:
- Statements
- Transactions
operationId: GetAccountStatementTransactions
summary: Get Statement Transactions
description: Get Statement Transactions related to an account
parameters:
- $ref: '#/parameters/AccountIdParam'
- $ref: '#/parameters/StatementIdParam'
- $ref: '#/parameters/FromBookingDateTimeParam'
- $ref: '#/parameters/ToBookingDateTimeParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Transactions successfully retrieved
schema:
type: object
properties:
Data:
type: object
properties:
Transaction:
items:
$ref: '#/definitions/TransactionModel'
type: array
description: Provides further details on an entry in the report.
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/standing-orders':
get:
tags:
- Standing Orders
operationId: GetStandingOrders
summary: Get Standing Orders
description: Get Standing Orders
parameters:
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Standing Orders successfully retrieved
schema:
title: Standing Orders GET response
type: object
properties:
Data:
title: Data
description: Data
type: object
properties:
StandingOrder:
title: StandingOrder
description: StandingOrder
type: array
items:
$ref: '#/definitions/StandingOrderModel'
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
additionalProperties: false
required:
- Data
- Links
- Meta
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/direct-debits':
get:
tags:
- Direct Debits
operationId: GetDirectDebits
summary: Get Direct Debits
description: Get Direct Debits
parameters:
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Direct Debits successfully retrieved
schema:
title: Direct Debit GET response
type: object
properties:
Data:
title: Data
description: Data
type: object
properties:
DirectDebit:
title: DirectDebit
description: DirectDebit
type: array
items:
$ref: '#/definitions/DirectDebitModel'
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/beneficiaries':
get:
tags:
- Beneficiaries
operationId: GetBeneficiaries
summary: Get Beneficiaries
description: Get Beneficiaries
parameters:
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Beneficiaries successfully retrieved
schema:
title: Beneficiaries GET response
type: object
properties:
Data:
title: Data
description: Data
type: object
properties:
Beneficiary:
title: Beneficiary
description: Beneficiary
type: array
items:
$ref: '#/definitions/BeneficiaryModel'
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/transactions':
get:
tags:
- Transactions
operationId: GetTransactions
summary: Get Transactions
description: Get Transactions
parameters:
- $ref: '#/parameters/FromBookingDateTimeParam'
- $ref: '#/parameters/ToBookingDateTimeParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Transactions successfully retrieved
schema:
title: Transactions GET response
type: object
properties:
Data:
title: Data
description: Data
type: object
properties:
Transaction:
title: Transaction
description: Transaction
type: array
items:
$ref: '#/definitions/TransactionModel'
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/balances':
get:
tags:
- Balances
operationId: GetBalances
summary: Get Balances
description: Get Balances
parameters:
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Balances successfully retrieved
schema:
title: Balances GET response
type: object
properties:
Data:
title: Data
description: Data
type: object
properties:
Balance:
title: Balance
description: Balance
type: array
items:
$ref: '#/definitions/BalanceModel'
required:
- Balance
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
additionalProperties: false
required:
- Data
- Links
- Meta
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/offers':
get:
tags:
- Offers
operationId: GetOffers
summary: Get Offers
description: Get Offers
parameters:
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Offers successfully retrieved
schema:
type: object
properties:
Data:
type: object
properties:
Offer:
items:
$ref: '#/definitions/OfferModel'
type: array
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/party':
get:
tags:
- Party
operationId: GetParty
summary: Get Party
description: Get Party of logged in Customer
parameters:
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Party successfully retrieved
schema:
type: object
properties:
Data:
type: object
properties:
Party:
$ref: '#/definitions/PartyModel'
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/scheduled-payments':
get:
tags:
- Scheduled Payments
operationId: GetScheduledPayments
summary: Get Scheduled Payments
description: Get Scheduled Payments
parameters:
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Scheduled Payment successfully retrieved
schema:
type: object
properties:
Data:
type: object
properties:
ScheduledPayment:
items:
$ref: '#/definitions/ScheduledPaymentModel'
type: array
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
'/statements':
get:
tags:
- Statements
summary: Get Statements
description: Get Statements
operationId: GetStatements
parameters:
- $ref: '#/parameters/FromStatementDateTimeParam'
- $ref: '#/parameters/ToStatementDateTimeParam'
- $ref: '#/parameters/x-fapi-auth-date-Param'
- $ref: '#/parameters/x-fapi-customer-ip-address-Param'
- $ref: '#/parameters/x-fapi-interaction-id-Param'
- $ref: '#/parameters/x-merchant-ip-address-Param'
- $ref: '#/parameters/x-customer-user-agent-Param'
- $ref: '#/parameters/AuthorizationParam'
responses:
'200':
description: Account Statement successfully retrieved
schema:
type: object
properties:
Data:
type: object
properties:
Statement:
items:
$ref: '#/definitions/StatementModel'
type: array
description: Provides further details on a statement.
additionalProperties: false
Links:
$ref: '#/definitions/Links'
Meta:
$ref: '#/definitions/Meta'
required:
- Data
- Links
- Meta
additionalProperties: false
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
'400':
$ref: '#/responses/400ErrorResponse'
'401':
$ref: '#/responses/401ErrorResponse'
'403':
$ref: '#/responses/403ErrorResponse'
'405':
$ref: '#/responses/405ErrorResponse'
'406':
$ref: '#/responses/406ErrorResponse'
'429':
$ref: '#/responses/429ErrorResponse'
'500':
$ref: '#/responses/500ErrorResponse'
'501':
$ref: '#/responses/501ErrorResponse'
'503':
$ref: '#/responses/503ErrorResponse'
security:
- CustomerOAuth2Security:
- accounts
parameters:
AccountIdParam:
name: AccountId
in: path
description: A unique identifier used to identify the account resource.
required: true
type: string
ConsentIdParam:
name: ConsentId
in: path
description: >-
Unique identification as assigned by the API Provider to uniquely identify the
account access consent.
required: true
type: string
FromBookingDateTimeParam:
in: query
name: fromBookingDateTime
type: string
format: date-time
description: >-
The UTC ISO 8601 Date Time to filter transactions FROM
NB Time component is optional - set to 00:00:00 for just Date.
If the Date Time contains a timezone, the API Provider must ignore the timezone
component.
StatementIdParam:
name: StatementId
in: path
description: A unique identifier used to identify the statement resource.
required: true
type: string
ToBookingDateTimeParam:
in: query
name: toBookingDateTime
type: string
format: date-time
description: >-
The UTC ISO 8601 Date Time to filter transactions TO
NB Time component is optional - set to 00:00:00 for just Date.
If the Date Time contains a timezone, the API Provider must ignore the timezone
component.
FromStatementDateTimeParam:
in: query
name: fromStatementDateTime
type: string
format: date-time
description: >-
The UTC ISO 8601 Date Time to filter statements FROM
NB Time component is optional - set to 00:00:00 for just Date.
If the Date Time contains a timezone, the API Provider must ignore the timezone
component.
ToStatementDateTimeParam:
in: query
name: toStatementDateTime
type: string
format: date-time
description: >-
The UTC ISO 8601 Date Time to filter statements TO
NB Time component is optional - set to 00:00:00 for just Date.
If the Date Time contains a timezone, the API Provider must ignore the timezone
component.
x-fapi-customer-ip-address-Param:
in: header
name: x-fapi-customer-ip-address
type: string
required: false
description: The Customer's IP address if the Customer is currently logged in with the Third Party.
pattern: ^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
x-fapi-interaction-id-Param:
in: header
name: x-fapi-interaction-id
type: string
required: false
description: An RFC4122 UID used as a correlation id.
x-fapi-auth-date-Param:
in: header
name: x-fapi-auth-date
type: string
required: false
description: >-
The time when the Customer last logged in with the Third Party.
All dates in the HTTP headers are represented as RFC 7231 Full Dates. An
example is below:
Sun, 10 Sep 2017 19:43:31 UTC
pattern: >-
^(Mon|Tue|Wed|Thu|Fri|Sat|Sun), \d{2}
(Jan|Feb|Mar|Apr|May|Jun|Jul|Aug|Sep|Oct|Nov|Dec) \d{4} \d{2}:\d{2}:\d{2}
(GMT|UTC)$
x-merchant-ip-address-Param:
in: header
name: x-merchant-ip-address
type: string
required: false
description: >-
The IP address of the merchant when making account information requests through a
Third Party.
pattern: ^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$
x-customer-user-agent-Param:
in: header
name: x-customer-user-agent
type: string
required: false
description: >-
The User-Agent of the application on the customer device that is used to
request the payment
AuthorizationParam:
in: header
name: Authorization
type: string
required: true
description: 'An Authorisation Token as per https://tools.ietf.org/html/rfc6750'
definitions:
Error:
type: object
properties:
ErrorCode:
description: >-
Low level textual error code.
type: string
enum:
- Field.Expected
- Field.Invalid
- Field.Missing
- Field.Unexpected
- Header.Invalid
- Header.Missing
- Reauthenticate
- Reauthorise
- Resource.Consent.CreditorAccount
- Resource.Consent.DebtorAccount
- Resource.Consent.Exceed.DataPermissions
- Resource.Consent.Exceed.Dates
- Resource.Consent.Exceed.Frequency
- Resource.Consent.Exceed.MaximumAmount
- Resource.Consent.Exceed.TotalAmount
- Resource.Consent.Exceed.TotalCount
- Resource.Consent.Exceed.TransactionDates
- Resource.Consent.InvalidStatus
- Resource.Consent.Mismatch
- Resource.Invalid
- UnexpectedError
- Unsupported.AccountIdentifier
- Unsupported.AccountSecondaryIdentifier
- Unsupported.Currency
- Unsupported.Scheme
Message:
description: >-
A free text description of the error that occurred. E.g.,
'A mandatory field isn't supplied'.
type: string
minLength: 1
maxLength: 500
Path:
description: >-
A recommended but optional reference to the JSON Path of the field
with error, e.g., Data.Consent.InstructedAmount.Currency
type: string
minLength: 1
maxLength: 500
Url:
description: >-
URL to help remediate the problem, provide more information or to
API Reference.
type: string
required:
- ErrorCode
- Message
additionalProperties: false
minProperties: 1
ErrorResponse:
description: >-
An array of detail error codes, and messages, and URLs to documentation to
help remediation.
type: object
properties:
Code:
description: >-
High level textual error code to help categorise the errors.
type: string
minLength: 1
maxLength: 128
Id:
description: >-
A unique reference for the error instance, for audit purposes, in
case of unknown/unclassified errors.
type: string
minLength: 1
maxLength: 128
Message:
description: >-
Brief Error message. E.g., 'There is something wrong with the request
parameters provided'
type: string
minLength: 1
maxLength: 500
Errors:
items:
$ref: '#/definitions/Error'
type: array
minItems: 1
required:
- Code
- Message
- Errors
additionalProperties: false
BalanceModel:
type: object
description: Balance object schema
properties:
AccountId:
description: >-
A unique and immutable identifier used to identify the account
resource. This identifier has no meaning to the account owner.
type: string
minLength: 1
maxLength: 40
Amount:
description: Amount of money of the cash balance.
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance Agency under an
international identification scheme, as described in the latest
edition of the international standard ISO 4217 'Codes for the
representation of currencies and funds'
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
CreditDebitIndicator:
description: >-
Indicates whether the balance is a credit or a debit balance. Usage: A
zero balance is considered to be a credit balance.
type: string
enum:
- Credit
- Debit
Type:
description: 'Balance type, in a coded form.'
type: string
enum:
- ClosingAvailable
- ClosingBooked
- Expected
- ForwardAvailable
- Information
- InterimAvailable
- InterimBooked
- OpeningAvailable
- OpeningBooked
- PreviouslyClosedBooked
DateTime:
description: >-
Indicates the date (and time) of the balance.
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
CreditLine:
type: array
items:
type: object
properties:
Included:
description: >-
Indicates whether or not the credit line is included in the
balance of the account. Usage: If not present, credit line is
not included in the balance amount of the account.
type: boolean
Amount:
description: Active Or Historic Currency Code and Amount
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance Agency under
an international identification scheme, as described in the
latest edition of the international standard ISO 4217 'Codes
for the representation of currencies and funds'
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
Type:
description: 'Limit type, in a coded form.'
type: string
enum:
- Pre-Agreed
- Emergency
- Temporary
additionalProperties: false
required:
- Included
additionalProperties: false
required:
- AccountId
- Amount
- CreditDebitIndicator
- DateTime
- Type
minItems: 1
additionalProperties: false
AccountModel:
type: object
properties:
AccountId:
description: >-
A unique and immutable identifier used to identify the account
resource. This identifier has no meaning to the account owner.
type: string
minLength: 1
maxLength: 40
Currency:
description: >-
Identification of the currency in which the account is held. Usage:
Currency should only be used in case one and the same account number
covers several currencies and the initiating party needs to identify
which currency needs to be used for settlement on the account.
type: string
pattern: '^[A-Z]{3,3}$'
AccountType:
description: Specifies the type of account (personal or business).
type: string
enum:
- Business
- Personal
AccountSubType:
description: Specifies the sub type of account (product family group).
type: string
enum:
- ChargeCard
- CreditCard
- CurrentAccount
- EMoney
- Loan
- Mortgage
- PrePaidCard
- Savings
Description:
description: Specifies the description of the account type.
type: string
minLength: 1
maxLength: 35
Nickname:
description: >-
The nickname of the account, assigned by the account owner in order to
provide an additional means of identification of the account.
type: string
minLength: 1
maxLength: 70
Account:
description: Provides the details to identify an account.
type: object
properties:
SchemeName:
$ref: '#/definitions/AccountSchemeModel'
Identification:
description: >-
Identification assigned by an institution to identify an account.
This identification is known by the account owner. For the NZ
market, this will use the hyphen-delimited format: 2-4-7-2
where this is made up of bank-branch-account-suffix and each
of the four components is a number, prepended with leading zeros
to match the component length requirement.
For example 12-0123-0012345-00
type: string
minLength: 1
maxLength: 34
Name:
description: >-
Name of the account, as assigned by the account servicing
institution, in agreement with the account owner in order to
provide an additional means of identification of the account.
Usage: The account name is different from the account owner name.
The account name is used in certain user communities to provide a
means of identifying the account, in addition to the account
owner's identity and the account number.
type: string
minLength: 1
maxLength: 70
SecondaryIdentification:
description: >-
This is secondary identification of the account, as assigned by
the account servicing institution.
type: string
minLength: 1
maxLength: 34
required:
- SchemeName
- Identification
additionalProperties: false
Servicer:
description: >-
Party that manages the account on behalf of the account owner, that is
manages the registration and booking of entries on the account,
calculates balances on the account and provides information about the
account.
type: object
properties:
SchemeName:
description: >-
Name of the identification scheme, in a coded form as published in
an external list.
type: string
enum:
- BICFI
Identification:
description: >-
Unique and unambiguous identification of the servicing
institution.
type: string
minLength: 1
maxLength: 35
required:
- SchemeName
- Identification
additionalProperties: false
additionalProperties: false
required:
- AccountId
- Currency
- Nickname
AccountSchemeModel:
type: string
enum:
- BECSElectronicCredit
default: BECSElectronicCredit
Links:
title: Links
type: object
description: Links relevant to the payload
properties:
Self:
type: string
format: uri
First:
type: string
format: uri
Prev:
type: string
format: uri
Next:
type: string
format: uri
Last:
type: string
format: uri
required:
- Self
Risk:
type: object
description: >-
The Risk section is sent by the initiating party to the API Provider.
It is used to specify additional details for risk scoring.
properties:
GeoLocation:
description: >-
Location of the end-user on the earth specified by two numbers
representing vertical and horizontal position
type: object
properties:
Latitude:
description: Latitude measured in decimal degress
type: string
maxLength: 14
pattern: '^-?\d{1,3}\.\d{1,8}$'
Longitude:
description: Longitude measured in decimal degress
type: string
maxLength: 14
pattern: '^-?\d{1,3}\.\d{1,8}$'
PaymentContextCode:
description: Specifies the payment context
title: PaymentContextCode
type: string
enum:
- BillPayment
- EcommerceGoods
- EcommerceServices
- Other
- PersonToPerson
MerchantCategoryCode:
description: >-
Category code conforms to ISO 18245, related to the type of services
or goods the merchant provides for the transaction
type: string
minLength: 3
maxLength: 4
MerchantCustomerIdentification:
description: The unique customer identifier of the Customer with the merchant.
type: string
minLength: 1
maxLength: 70
DeliveryAddress:
description: >-
Information that locates and identifies a specific
address, as defined by postal services or in free format
text.
type: object
properties:
AddressType:
description: >-
Identifies the nature of the postal address.
type: string
enum:
- DeliveryTo
AddressLine:
description: >-
Information that locates and identifies a specific
address, as defined by postal services, that is
presented in free format text.
type: array
items:
type: string
minLength: 1
maxLength: 70
minItems: 0
maxItems: 5
StreetName:
description: >-
Name of a street or thoroughfare.
type: string
minLength: 1
maxLength: 70
BuildingNumber:
description: >-
Number that identifies the position of a building on a
street.
type: string
minLength: 1
maxLength: 16
PostCode:
description: >-
Identifier consisting of a group of letters and/or
numbers that is added to a postal address to assist
the sorting of mail
type: string
minLength: 1
maxLength: 16
TownName:
description: >-
Name of a built-up area, with defined boundaries, and
a local government.
type: string
minLength: 1
maxLength: 35
CountrySubDivision:
description: >-
Identifies a subdivision of a country, for instance
state, region, county.
type: string
minLength: 1
maxLength: 35
Country:
description: >-
Nation with its own government, occupying a particular
territory.
type: string
pattern: '^[A-Z]{2,2}$'
required:
- Country
additionalProperties: false
EndUserAppName:
description: Name of the end user facing application
type: string
minLength: 1
maxLength: 70
EndUserAppVersion:
description: Version of the end user facing application
type: string
minLength: 1
maxLength: 14
MerchantName:
description: Name of the merchant
type: string
minLength: 1
maxLength: 70
MerchantNZBN:
description: NZ business number for the merchant
type: string
minLength: 1
maxLength: 70
additionalProperties: false
AccountAccessConsentModel:
type: object
properties:
Consent:
description: >-
Contains the requested consent
type: object
properties:
Permissions:
description: >-
Specifies the Open Banking account access consent types. This is a
list of the data clusters being consented by the Customer, and requested
for authorisation with the API Provider.
type: array
items:
description: >-
Specifies the Open Banking account access consent types. This is a
list of the data clusters being consented by the Customer, and
requested for authorisation with the API Provider.
type: string
enum:
- ReadAccountsBasic
- ReadAccountsDetail
- ReadBalances
- ReadBeneficiariesBasic
- ReadBeneficiariesDetail
- ReadDirectDebits
- ReadOffers
- ReadPAN
- ReadParty
- ReadPartyAuthUser
- ReadScheduledPaymentsBasic
- ReadScheduledPaymentsDetail
- ReadStandingOrdersBasic
- ReadStandingOrdersDetail
- ReadStatementsBasic
- ReadStatementsDetail
- ReadTransactionsBasic
- ReadTransactionsCredits
- ReadTransactionsDebits
- ReadTransactionsDetail
minProperties: 1
additionalProperties: false
ExpirationDateTime:
description: >-
Specified date and time the permissions will expire. If this is not
populated, the permissions will be open ended.
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
TransactionFromDateTime:
description: >-
Specified start date and time for the transaction query period. If
this is not populated, the start date will be open ended, and data
will be returned from the earliest available transaction.
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
TransactionToDateTime:
description: >-
Specified end date and time for the transaction query period. If this
is not populated, the end date will be open ended, and data will be
returned to the latest available transaction.
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
required:
- Permissions
additionalProperties: false
additionalProperties: false
required:
- Consent
AccountAccessConsentResponseModel:
type: object
allOf:
- properties:
ConsentId:
description: >-
Unique identification as assigned to identify the account access consent.
type: string
minLength: 1
maxLength: 128
Status:
description: Specifies the status of the account access consent.
type: string
enum:
- Authorised
- AwaitingAuthorisation
- Rejected
- Revoked
CreationDateTime:
description: >-
Date and time at which the consent was created.
All dates in the JSON payloads are represented in ISO 8601
date-time format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
StatusUpdateDateTime:
description: >-
Date and time at which the consent status was updated.
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
required:
- ConsentId
- Status
- CreationDateTime
- StatusUpdateDateTime
additionalProperties: false
- $ref: '#/definitions/AccountAccessConsentModel'
TransactionModel:
type: object
properties:
AccountId:
description: >-
A unique and immutable identifier used to identify
the account resource. This identifier has no meaning
to the account owner.
type: string
minLength: 1
maxLength: 40
TransactionId:
description: >-
Unique identifier for the transaction within an
servicing institution. This identifier is both
unique and immutable.
type: string
minLength: 1
maxLength: 40
TransactionReference:
$ref: '#/definitions/BECSRemittance'
StatementReference:
type: array
items:
description: >-
Unique reference for the statement. This reference may be optionally
populated if available.
type: string
minLength: 1
maxLength: 35
description: >-
Unique reference for the statement. This reference may be optionally
populated if available.
Amount:
description: Amount of money in the cash entry.
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance
Agency under an international identification
scheme, as described in the latest edition of
the international standard ISO 4217 'Codes for
the representation of currencies and funds'
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
CreditDebitIndicator:
description: >-
Indicates whether the transaction is a credit or a
debit entry.
type: string
enum:
- Credit
- Debit
Status:
description: >-
Status of a transaction entry on the books of the
account servicer.
type: string
enum:
- Booked
- Pending
BookingDateTime:
description: >-
Date and time when a transaction entry is posted to
an account on the account servicer's books. Usage:
Booking date is the expected booking date, unless
the status is booked, in which case it is the actual
booking date.
All dates in the JSON payloads are represented in
ISO 8601 date-time format.
All date-time fields in responses must include the
timezone. An example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
ValueDateTime:
description: >-
Date and time at which assets become available to
the account owner in case of a credit entry, or
cease to be available to the account owner in case
of a debit entry. Usage: If entry status is pending
and value date is present, then the value date
refers to an expected/requested value date. For
entries subject to availability/float and for which
availability information is provided, the value date
must not be used. In this case the availability
component identifies the number of availability
days.
All dates in the JSON payloads are represented in
ISO 8601 date-time format.
All date-time fields in responses must include the
timezone. An example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
AddressLine:
description: >-
Information that locates and identifies a specific
address, as defined by postal services, that is
presented in free format text.
type: string
minLength: 1
maxLength: 70
BankTransactionCode:
description: >-
Set of elements used to fully identify the type of
underlying transaction resulting in an entry.
type: object
properties:
Code:
description: Specifies the family within a domain.
type: string
SubCode:
description: >-
Specifies the sub-product family within a
specific family.
type: string
required:
- Code
- SubCode
additionalProperties: false
ProprietaryBankTransactionCode:
description: >-
Set of elements to fully identify a proprietary bank
transaction code.
type: object
properties:
Code:
description: >-
Proprietary bank transaction code to identify
the underlying transaction.
type: string
minLength: 1
maxLength: 35
Issuer:
description: >-
Identification of the issuer of the proprietary
bank transaction code.
type: string
minLength: 1
maxLength: 35
required:
- Code
additionalProperties: false
CurrencyExchange:
description: Set of elements used to provide details on the currency exchange.
type: object
properties:
SourceCurrency:
description: >-
Currency from which an amount is to be converted in a currency
conversion.
type: string
pattern: '^[A-Z]{3,3}$'
TargetCurrency:
description: >-
Currency from which an amount is to be converted in a currency
conversion.
type: string
pattern: '^[A-Z]{3,3}$'
UnitCurrency:
description: >-
Currency from which an amount is to be converted in a currency
conversion.
type: string
pattern: '^[A-Z]{3,3}$'
ExchangeRate:
description: >-
Factor used to convert an amount from one currency into another. This
reflects the price at which one currency was bought with another
currency.
Usage: ExchangeRate expresses the ratio between UnitCurrency and
QuotedCurrency (ExchangeRate = UnitCurrency/QuotedCurrency).
type: number
ContractIdentification:
description: >-
Unique identification to unambiguously identify the foreign exchange
contract.
type: string
minLength: 1
maxLength: 35
QuotationDate:
description: >-
Date and time at which an exchange rate is quoted.
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
InstructedAmount:
description: >-
Amount of money of the cash balance after a transaction entry is applied
to the account..
type: object
properties:
Amount:
description: >-
A number of monetary units specified in an active currency where the unit
of currency is explicit and compliant with ISO 4217.
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance Agency under an
international identification scheme, as described in the latest
edition of the international standard ISO 4217 "Codes for the
representation of currencies and funds".
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
required:
- SourceCurrency
- ExchangeRate
additionalProperties: false
CreditorAgent:
type: object
properties:
SchemeName:
description: >-
Name of the identification scheme, in a coded form as published in
an external list.
type: string
enum:
- BICFI
Identification:
type: string
minLength: 1
maxLength: 35
description: >-
Unique and unambiguous identification of a financial institution
or a branch of a financial institution.
required:
- SchemeName
- Identification
additionalProperties: false
description: Financial institution servicing an account for the creditor.
DebtorAgent:
type: object
properties:
SchemeName:
description: >-
Name of the identification scheme, in a coded form as published in
an external list.
type: string
enum:
- BICFI
Identification:
type: string
minLength: 1
maxLength: 35
description: >-
Unique and unambiguous identification of a financial institution
or a branch of a financial institution.
required:
- SchemeName
- Identification
additionalProperties: false
description: Financial institution servicing an account for the debtor.
CardInstrument:
description: >-
Set of elements to describe the card instrument used in the
transaction.
type: object
properties:
CardSchemeName:
description: Name of the card scheme.
type: string
enum:
- AmericanExpress
- Diners
- Discover
- MasterCard
- VISA
AuthorisationType:
description: The card authorisation type.
type: string
enum:
- Contactless
- None
- PIN
Name:
description: Name of the cardholder using the card instrument.
type: string
minLength: 1
maxLength: 70
Identification:
description: >-
Identification assigned by an institution to identify the card
instrument used in the transaction. This identification is known
by the account owner, and may be masked.
type: string
minLength: 1
maxLength: 34
required:
- CardSchemeName
additionalProperties: false
TransactionInformation:
description: >-
Further details of the transaction. This is the
transaction narrative, which is unstructured text.
type: string
minLength: 1
maxLength: 500
Balance:
description: >-
Set of elements used to define the balance as a
numerical representation of the net increases and
decreases in an account after a transaction entry is
applied to the account.
type: object
properties:
Amount:
description: >-
Amount of money of the cash balance after a
transaction entry is applied to the account..
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a
Maintenance Agency under an international
identification scheme, as described in the
latest edition of the international standard
ISO 4217 'Codes for the representation of
currencies and funds'
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
CreditDebitIndicator:
description: >-
Indicates whether the balance is a credit or a
debit balance. Usage: A zero balance is
considered to be a credit balance.
type: string
enum:
- Credit
- Debit
Type:
description: 'Balance type, in a coded form.'
type: string
enum:
- ClosingAvailable
- ClosingBooked
- Expected
- ForwardAvailable
- Information
- InterimAvailable
- InterimBooked
- OpeningAvailable
- OpeningBooked
- PreviouslyClosedBooked
required:
- Amount
- CreditDebitIndicator
- Type
additionalProperties: false
MerchantDetails:
description: Details of the merchant involved in the transaction.
type: object
properties:
MerchantName:
description: Name by which the merchant is known.
type: string
minLength: 1
maxLength: 350
MerchantCategoryCode:
description: >-
Category code conform to ISO 18245, related to
the type of services or goods the merchant
provides for the transaction.
type: string
minLength: 3
maxLength: 4
additionalProperties: false
CreditorAccount:
type: object
properties:
SchemeName:
$ref: '#/definitions/AccountSchemeModel'
Identification:
description: >-
Identification assigned by an institution to
identify an account. This identification is
known by the account owner. For the NZ
market, this will use the hyphen-delimited format: 2-4-7-2
where this is made up of bank-branch-account-suffix and each
of the four components is a number, prepended with leading zeros
to match the component length requirement.
For example 12-0123-0012345-00
type: string
minLength: 1
maxLength: 34
Name:
type: string
minLength: 1
maxLength: 70
description: >-
Name of the account, as assigned by the account servicing
institution, in agreement with the account owner in order to
provide an additional means of identification of the account.
Usage: The account name is different from the account owner name.
The account name is used in certain user communities to provide a
means of identifying the account, in addition to the account
owner's identity and the account number.
SecondaryIdentification:
type: string
minLength: 1
maxLength: 34
description: >-
This is secondary identification of the account, as assigned by
the account servicing institution.
required:
- SchemeName
- Identification
additionalProperties: false
description: >-
Unambiguous identification of the account of the creditor, in the case
of a debit transaction.
DebtorAccount:
type: object
properties:
SchemeName:
$ref: '#/definitions/AccountSchemeModel'
Identification:
description: >-
Identification assigned by an institution to
identify an account. This identification is
known by the account owner. For the NZ
market, this will use the hyphen-delimited format: 2-4-7-2
where this is made up of bank-branch-account-suffix and each
of the four components is a number, prepended with leading zeros
to match the component length requirement.
For example 12-0123-0012345-00
type: string
minLength: 1
maxLength: 34
Name:
type: string
minLength: 1
maxLength: 70
description: >-
Name of the account, as assigned by the account servicing
institution, in agreement with the account owner in order to
provide an additional means of identification of the account.
Usage: The account name is different from the account owner name.
The account name is used in certain user communities to provide a
means of identifying the account, in addition to the account
owner's identity and the account number.
SecondaryIdentification:
type: string
minLength: 1
maxLength: 34
description: >-
This is secondary identification of the account, as assigned by
the account servicing institution.
required:
- SchemeName
- Identification
additionalProperties: false
description: >-
Unambiguous identification of the account of the debtor, in the case
of a crebit transaction.
required:
- AccountId
- Amount
- CreditDebitIndicator
- Status
- BookingDateTime
additionalProperties: false
BeneficiaryModel:
type: object
properties:
AccountId:
description: >-
A unique and immutable identifier used to identify
the account resource. This identifier has no meaning
to the account owner.
type: string
minLength: 1
maxLength: 40
BeneficiaryId:
description: >-
A unique and immutable identifier used to identify
the beneficiary resource. This identifier has no
meaning to the account owner.
type: string
minLength: 1
maxLength: 40
Reference:
$ref: '#/definitions/BECSRemittance'
CreditorAgent:
description: >-
Party that manages the account on behalf of the account owner, that is
manages the registration and booking of entries on the account,
calculates balances on the account and provides information about the
account.
This is the servicer of the beneficiary account.
type: object
properties:
SchemeName:
description: >-
Name of the identification scheme, in a coded form as published in
an external list.
type: string
enum:
- BICFI
Identification:
description: >-
Unique and unambiguous identification of the servicing
institution.
type: string
minLength: 1
maxLength: 35
Name:
description: >-
Name by which an agent is known and which is usually used to
identify that agent.
type: string
minLength: 1
maxLength: 140
PostalAddress:
description: >-
Information that locates and identifies a specific address, as
defined by postal services.
type: object
properties:
AddressType:
description: Identifies the nature of the postal address.
type: string
enum:
- Business
- Correspondence
- DeliveryTo
- MailTo
- POBox
- Postal
- Residential
- Statement
AddressLine:
description: >-
Information that locates and identifies a specific
address, as defined by postal services, that is
presented in free format text.
type: array
items:
type: string
minLength: 1
maxLength: 70
minItems: 0
maxItems: 5
StreetName:
description: Name of a street or thoroughfare.
type: string
minLength: 1
maxLength: 70
BuildingNumber:
description: >-
Number that identifies the position of a building on a street.
type: string
minLength: 1
maxLength: 16
PostCode:
description: >-
Identifier consisting of a group of letters and/or numbers
that is added to a postal address to assist the sorting of
mail.
type: string
minLength: 1
maxLength: 16
TownName:
description: >-
Name of a built-up area, with defined boundaries, and a local
government.
type: string
minLength: 1
maxLength: 35
CountrySubDivision:
description: >-
Identifies a subdivision of a country such as state, region,
county.
type: string
minLength: 1
maxLength: 35
Country:
description: Nation with its own government.
type: string
pattern: '^[A-Z]{2,2}$'
required:
- Country
additionalProperties: false
additionalProperties: false
CreditorAccount:
description: >-
Provides the details to identify the beneficiary
account.
type: object
properties:
SchemeName:
$ref: '#/definitions/AccountSchemeModel'
Identification:
description: >-
Identification assigned by an institution to
identify an account. This identification is
known by the account owner. For the NZ
market, this will use the hyphen-delimited format: 2-4-7-2
where this is made up of bank-branch-account-suffix and each
of the four components is a number, prepended with leading zeros
to match the component length requirement.
For example 12-0123-0012345-00
type: string
minLength: 1
maxLength: 34
Name:
description: >-
Name of the account, as assigned by the account
servicing institution, in agreement with the
account owner in order to provide an additional
means of identification of the account. Usage:
The account name is different from the account
owner name. The account name is used in certain
user communities to provide a means of
identifying the account, in addition to the
account owner's identity and the account number.
type: string
minLength: 1
maxLength: 70
SecondaryIdentification:
description: >-
This is secondary identification of the account, as assigned by the
account servicing institution.
type: string
minLength: 1
maxLength: 34
required:
- SchemeName
- Identification
additionalProperties: false
required:
- AccountId
additionalProperties: false
StandingOrderModel:
type: object
properties:
AccountId:
description: >-
A unique and immutable identifier used to identify
the account resource. This identifier has no meaning
to the account owner.
type: string
minLength: 1
maxLength: 40
StandingOrderId:
description: >-
A unique and immutable identifier used to identify
the standing order resource. This identifier has no
meaning to the account owner.
type: string
minLength: 1
maxLength: 40
Frequency:
description: >
EvryDay - Every day
EvryWorkgDay - Every working day
IntrvlWkDay - An interval specified in weeks (01 to
09), and the day within the week (01 to 07)
WkInMnthDay - A monthly interval, specifying the
week of the month (01 to 05) and day within the week
(01 to 07)
IntrvlMnthDay - An interval specified in months
(between 01 to 06, 12, 24), specifying the day
within the month (-5 to -1, 1 to 31)
Patterns:
EvryDay (ScheduleCode)
EvryWorkgDay (ScheduleCode)
IntrvlWkDay:IntervalInWeeks:DayInWeek (ScheduleCode
+ IntervalInWeeks + DayInWeek)
WkInMnthDay:WeekInMonth:DayInWeek (ScheduleCode +
WeekInMonth + DayInWeek)
IntrvlMnthDay:IntervalInMonths:DayInMonth
(ScheduleCode + IntervalInMonths + DayInMonth)
The regular expression for this element combines
five smaller versions for each permitted pattern. To
aid legibility - the components are presented
individually here:
EvryDay
EvryWorkgDay
IntrvlWkDay:0[1-9]:0[1-7]
WkInMnthDay:0[1-5]:0[1-7]
IntrvlMnthDay:(0[1-6]|12|24):(-0[1-5]|0[1-9]|[12][0-9]|3[01])
type: string
pattern: >-
^(EvryDay)$|^(EvryWorkgDay)$|^(IntrvlWkDay:0[1-9]:0[1-7])$|^(WkInMnthDay:0[1-5]:0[1-7])$|^(IntrvlMnthDay:(0[1-6]|12|24):(-0[1-5]|0[1-9]|[12][0-9]|3[01]))$
Reference:
$ref: '#/definitions/BECSRemittance'
FirstPaymentDateTime:
description: >-
The date on which the first payment for a Standing
Order schedule will be made.
All dates in the JSON payloads are represented in
ISO 8601 date-time format.
All date-time fields in responses must include the
timezone. An example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
FirstPaymentAmount:
description: The amount of the first Standing Order
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance
Agency under an international identification
scheme, as described in the latest edition of
the international standard ISO 4217 'Codes for
the representation of currencies and funds'
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
NextPaymentDateTime:
description: >-
The date on which the next payment for a Standing
Order schedule will be made.
All dates in the JSON payloads are represented in
ISO 8601 date-time format.
All date-time fields in responses must include the
timezone. An example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
NextPaymentAmount:
description: The amount of the next Standing Order
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance
Agency under an international identification
scheme, as described in the latest edition of
the international standard ISO 4217 'Codes for
the representation of currencies and funds'
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
FinalPaymentDateTime:
description: >-
The date on which the final payment for a Standing
Order schedule will be made.
All dates in the JSON payloads are represented in
ISO 8601 date-time format.
All date-time fields in responses must include the
timezone. An example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
FinalPaymentAmount:
description: The amount of the final Standing Order
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance
Agency under an international identification
scheme, as described in the latest edition of
the international standard ISO 4217 'Codes for
the representation of currencies and funds'
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
StandingOrderStatusCode:
description: Specifies the status of the standing order in code form.
type: string
enum:
- Active
- Inactive
CreditorAgent:
description: >-
Party that manages the account on behalf of the
account owner, that is manages the registration and
booking of entries on the account, calculates
balances on the account and provides information
about the account. This is the servicer of the
beneficiary account
type: object
properties:
SchemeName:
description: >-
Name of the identification scheme, in a coded
form as published in an external list.
type: string
enum:
- BICFI
Identification:
description: >-
Unique and unambiguous identification of the
servicing institution.
type: string
minLength: 1
maxLength: 35
required:
- SchemeName
- Identification
additionalProperties: false
CreditorAccount:
description: >-
Provides the details to identify the beneficiary
account.
type: object
properties:
SchemeName:
$ref: '#/definitions/AccountSchemeModel'
Identification:
description: >-
Identification assigned by an institution to
identify an account. This identification is
known by the account owner. For the NZ
market, this will use the hyphen-delimited format: 2-4-7-2
where this is made up of bank-branch-account-suffix and each
of the four components is a number, prepended with leading zeros
to match the component length requirement.
For example 12-0123-0012345-00
type: string
minLength: 1
maxLength: 34
Name:
description: >-
Name of the account, as assigned by the account
servicing institution, in agreement with the
account owner in order to provide an additional
means of identification of the account. Usage:
The account name is different from the account
owner name. The account name is used in certain
user communities to provide a means of
identifying the account, in addition to the
account owner's identity and the account number.
type: string
minLength: 1
maxLength: 70
SecondaryIdentification:
description: >-
This is secondary identification of the account,
as assigned by the account servicing institution.
type: string
minLength: 1
maxLength: 34
required:
- SchemeName
- Identification
additionalProperties: false
required:
- AccountId
- Frequency
- NextPaymentDateTime
- NextPaymentAmount
additionalProperties: false
DirectDebitModel:
type: object
properties:
AccountId:
description: >-
A unique and immutable identifier used to identify
the account resource. This identifier has no meaning
to the account owner.
type: string
minLength: 1
maxLength: 40
DirectDebitId:
description: >-
A unique and immutable identifier used to identify
the direct debit resource. This identifier has no
meaning to the account owner.
type: string
minLength: 1
maxLength: 40
MandateIdentification:
description: >-
Direct Debit reference.
type: string
minLength: 1
maxLength: 35
DirectDebitStatusCode:
description: >-
Specifies the status of the direct debit in code
form.
type: string
enum:
- Active
- Inactive
Name:
description: Name of Service User
type: string
minLength: 1
maxLength: 70
PreviousPaymentDateTime:
description: >-
Date of most recent direct debit collection.
All dates in the JSON payloads are represented in
ISO 8601 date-time format.
All date-time fields in responses must include the
timezone. An example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
PreviousPaymentAmount:
description: >-
The amount of the most recent direct debit
collection.
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance
Agency under an international identification
scheme, as described in the latest edition of
the international standard ISO 4217 'Codes for
the representation of currencies and funds'
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
required:
- AccountId
- MandateIdentification
- Name
additionalProperties: false
OfferModel:
type: object
properties:
AccountId:
description: >-
A unique and immutable identifier used to identify
the account resource. This identifier has no meaning
to the account owner.
type: string
minLength: 1
maxLength: 40
OfferId:
description: >-
A unique and immutable identifier used to identify the offer resource.
This identifier has no meaning to the account owner.
type: string
minLength: 1
maxLength: 40
OfferType:
description: 'Offer type, in a coded form.'
type: string
enum:
- BalanceTransfer
- LimitIncrease
- MoneyTransfer
- Other
- PromotionalRate
Description:
description: Further details of the offer.
type: string
minLength: 1
maxLength: 500
StartDateTime:
description: >-
Date and time at which the offer starts.
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
EndDateTime:
description: >-
Date and time at which the offer ends.
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
Amount:
description: Amount of money associated with the offer type.
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance Agency under an
international identification scheme, as described in the latest
edition of the international standard ISO 4217 "Codes for the
representation of currencies and funds".
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
Fee:
description: Fee associated with the offer type.
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance Agency under an
international identification scheme, as described in the latest
edition of the international standard ISO 4217 "Codes for the
representation of currencies and funds".
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
Rate:
description: Rate associated with the offer type.
type: string
minLength: 1
maxLength: 10
pattern: '^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$'
Value:
description: Value associated with the offer type.
type: integer
format: int32
Term:
description: Further details of the term of the offer.
type: string
minLength: 1
maxLength: 500
URL:
description: URL (Uniform Resource Locator) where the document can be found
type: string
minLength: 1
maxLength: 256
required:
- AccountId
additionalProperties: false
PartyModel:
type: object
properties:
PartyId:
description: >-
A unique and immutable identifier used to identify the customer
resource. This identifier has no meaning to the account owner.
type: string
minLength: 1
maxLength: 40
PartyNumber:
description: Number assigned by an agent to identify its customer.
type: string
minLength: 1
maxLength: 35
PartyType:
description: 'Party type, in a coded form.'
type: string
enum:
- Delegate
- Joint
- Sole
Name:
description: >-
Name by which a party is known and which is usually used to identify
that party.
type: string
minLength: 1
maxLength: 70
EmailAddress:
description: Address for electronic mail (e-mail).
type: string
minLength: 1
maxLength: 256
Phone:
description: >-
Collection of information that identifies a phone number, as defined
by telecom services.
type: string
pattern: '\+[0-9]{1,3}-[0-9()+\-]{1,30}'
Mobile:
description: >-
Collection of information that identifies a mobile phone number, as
defined by telecom services.
type: string
pattern: '\+[0-9]{1,3}-[0-9()+\-]{1,30}'
Address:
type: array
description: Postal address of a party.
items:
description: Postal address of a party.
type: object
properties:
AddressType:
description: Identifies the nature of the postal address.
type: string
enum:
- Business
- Correspondence
- DeliveryTo
- MailTo
- POBox
- Postal
- Residential
- Statement
AddressLine:
description: >-
Information that locates and identifies a specific
address, as defined by postal services, that is
presented in free format text.
type: array
items:
type: string
minLength: 1
maxLength: 70
minItems: 0
maxItems: 5
StreetName:
description: >-
Name of a street or thoroughfare.
type: string
minLength: 1
maxLength: 70
BuildingNumber:
description: >-
Number that identifies the position of a building on a street.
type: string
minLength: 1
maxLength: 16
PostCode:
description: >-
Identifier consisting of a group of letters and/or numbers that is
added to a postal address to assist the sorting of mail.
type: string
minLength: 1
maxLength: 16
TownName:
description: >-
Name of a built-up area, with defined boundaries, and a local
government.
type: string
minLength: 1
maxLength: 35
CountrySubDivision:
description: >-
Identifies a subdivision of a country eg, state, region, county.
type: string
minLength: 1
maxLength: 35
Country:
description: >-
Nation with its own government, occupying a particular territory.
type: string
pattern: '^[A-Z]{2,2}$'
required:
- Country
additionalProperties: false
required:
- PartyId
additionalProperties: false
ScheduledPaymentModel:
type: object
properties:
AccountId:
description: >-
A unique and immutable identifier used to identify the account
resource. This identifier has no meaning to the account owner.
type: string
minLength: 1
maxLength: 40
ScheduledPaymentId:
description: >-
A unique and immutable identifier used to identify the scheduled
payment resource. This identifier has no meaning to the account owner.
type: string
minLength: 1
maxLength: 40
ScheduledPaymentDateTime:
description: >-
The date on which the scheduled payment will be made.
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
ScheduledType:
description: Specifies the scheduled payment date type requested
type: string
enum:
- Arrival
- Execution
InstructedAmount:
description: >-
Amount of money to be moved between the debtor and creditor, before
deduction of charges, expressed in the currency as ordered by the
initiating party.
Usage: This amount has to be transported unchanged through the
transaction chain.
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance Agency under an
international identification scheme, as described in the latest
edition of the international standard ISO 4217 "Codes for the
representation of currencies and funds".
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
Reference:
$ref: '#/definitions/BECSRemittance'
CreditorAgent:
type: object
properties:
SchemeName:
description: >-
Name of the identification scheme, in a coded form as published in
an external list.
type: string
enum:
- BICFI
Identification:
type: string
minLength: 1
maxLength: 35
description: >-
Unique and unambiguous identification of a financial institution
or a branch of a financial institution.
required:
- SchemeName
- Identification
additionalProperties: false
description: Financial institution servicing an account for the creditor.
CreditorAccount:
type: object
properties:
SchemeName:
$ref: '#/definitions/AccountSchemeModel'
Identification:
description: >-
Identification assigned by an institution to
identify an account. This identification is
known by the account owner. For the NZ
market, this will use the hyphen-delimited format: 2-4-7-2
where this is made up of bank-branch-account-suffix and each
of the four components is a number, prepended with leading zeros
to match the component length requirement.
For example 12-0123-0012345-00
type: string
minLength: 1
maxLength: 34
Name:
type: string
minLength: 1
maxLength: 70
description: >-
Name of the account, as assigned by the account servicing
institution, in agreement with the account owner in order to
provide an additional means of identification of the account.
Usage: The account name is different from the account owner name.
The account name is used in certain user communities to provide a
means of identifying the account, in addition to the account
owner's identity and the account number.
SecondaryIdentification:
type: string
minLength: 1
maxLength: 34
description: >-
This is secondary identification of the account, as assigned by
the account servicing institution.
required:
- SchemeName
- Identification
additionalProperties: false
description: Provides the details to identify the beneficiary account.
required:
- AccountId
- ScheduledPaymentDateTime
- ScheduledType
- InstructedAmount
additionalProperties: false
StatementModel:
description: Provides further details on a statement resource.
type: object
properties:
AccountId:
description: >-
A unique and immutable identifier used to identify the account
resource. This identifier has no meaning to the account owner.
type: string
minLength: 1
maxLength: 40
StatementId:
description: >-
Unique identifier for the statement resource within an servicing
institution. This identifier is both unique and immutable.
type: string
minLength: 1
maxLength: 40
StatementReference:
description: >-
Unique reference for the statement. This reference may be optionally
populated if available.
type: string
minLength: 1
maxLength: 35
Type:
description: 'Statement type, in a coded form.'
type: string
enum:
- AccountClosure
- AccountOpening
- Annual
- Interim
- RegularPeriodic
StartDateTime:
description: >-
Date and time at which the statement period starts.
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
EndDateTime:
description: >-
Date and time at which the statement period ends.
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
CreationDateTime:
description: >-
Date and time at which the resource was created.
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
StatementDescription:
items:
description: >-
Other descriptions that may be available for the statement resource.
type: string
minLength: 1
maxLength: 500
type: array
description: >-
Other descriptions that may be available for the statement resource.
StatementBenefit:
type: array
description: >-
Set of elements used to provide details of a benefit or reward amount
for the statement resource.
items:
description: >-
Set of elements used to provide details of a benefit or reward
amount for the statement resource.
type: object
properties:
Amount:
description: Amount of money associated with the statement benefit type.
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance Agency under
an international identification scheme, as described in the
latest edition of the international standard ISO 4217 "Codes
for the representation of currencies and funds".
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
Type:
description: 'Benefit type, in a coded form.'
type: string
enum:
- Cashback
- Insurance
- TravelDiscount
- TravelInsurance
required:
- Amount
- Type
additionalProperties: false
StatementFee:
type: array
description: >-
Set of elements used to provide details of a fee for the statement
resource.
items:
description: >-
Set of elements used to provide details of a fee for the statement
resource.
type: object
properties:
Amount:
description: Amount of money associated with the statement fee type.
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance Agency under
an international identification scheme, as described in the
latest edition of the international standard ISO 4217 "Codes
for the representation of currencies and funds".
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
CreditDebitIndicator:
type: string
enum:
- Credit
- Debit
description: >-
Indicates whether the amount is a credit or a debit.
Usage: A zero amount is considered to be a credit amount.
Type:
description: 'Fee type, in a coded form.'
type: string
enum:
- Annual
- BalanceTransfer
- CashAdvance
- CashTransaction
- ForeignTransaction
- Gambling
- LatePayment
- MoneyTransfer
- Monthly
- Overlimit
- PostalOrder
- PrizeEntry
- StatementCopy
- Total
required:
- Amount
- CreditDebitIndicator
- Type
additionalProperties: false
StatementInterest:
type: array
description: >-
Set of elements used to provide details of a generic interest amount
related to the statement resource.
items:
description: >-
Set of elements used to provide details of a generic interest amount
related to the statement resource.
type: object
properties:
Amount:
description: >-
Amount of money associated with the statement interest amount
type.
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance Agency under
an international identification scheme, as described in the
latest edition of the international standard ISO 4217 "Codes
for the representation of currencies and funds".
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
CreditDebitIndicator:
type: string
enum:
- Credit
- Debit
description: >-
Indicates whether the amount is a credit or a debit.
Usage: A zero amount is considered to be a credit amount.
Type:
description: 'Interest amount type, in a coded form.'
type: string
enum:
- BalanceTransfer
- Cash
- EstimatedNext
- Purchase
- Total
required:
- Amount
- CreditDebitIndicator
- Type
additionalProperties: false
StatementDateTime:
type: array
description: >-
Set of elements used to provide details of a generic date time for the
statement resource.
items:
description: >-
Set of elements used to provide details of a generic date time for
the statement resource.
type: object
properties:
DateTime:
description: >-
Date and time associated with the date time type.
All dates in the JSON payloads are represented in ISO 8601
date-time format.
All date-time fields in responses must include the timezone. An
example is below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
Type:
description: 'Date time type, in a coded form.'
type: string
enum:
- BalanceTransferPromoEnd
- DirectDebitDue
- LastPayment
- LastStatement
- NextStatement
- PaymentDue
- PurchasePromoEnd
- StatementAvailable
required:
- DateTime
- Type
additionalProperties: false
StatementRate:
type: array
description: >-
Set of elements used to provide details of a generic rate related to
the statement resource.
items:
description: >-
Set of elements used to provide details of a generic rate related to
the statement resource.
type: object
properties:
Rate:
description: Rate associated with the statement rate type.
type: string
minLength: 1
maxLength: 10
pattern: '^(-?\d{1,3}){1}(\.\d{1,4}){0,1}$'
Type:
description: 'Statement rate type, in a coded form.'
type: string
enum:
- AnnualBalanceTransfer
- AnnualBalanceTransferAfterPromo
- AnnualBalanceTransferPromo
- AnnualCash
- AnnualPurchase
- AnnualPurchaseAfterPromo
- AnnualPurchasePromo
- MonthlyBalanceTransfer
- MonthlyCash
- MonthlyPurchase
required:
- Rate
- Type
additionalProperties: false
StatementValue:
type: array
description: >-
Set of elements used to provide details of a generic number value
related to the statement resource.
items:
description: >-
Set of elements used to provide details of a generic number value
related to the statement resource.
type: object
properties:
Value:
description: Value associated with the statement value type.
type: integer
format: int32
Type:
description: 'Statement value type, in a coded form.'
type: string
enum:
- AirMilesPoints
- AirMilesPointsBalance
- Credits
- Debits
- HotelPoints
- HotelPointsBalance
- RetailShoppingPoints
- RetailShoppingPointsBalance
required:
- Value
- Type
additionalProperties: false
StatementAmount:
type: array
description: >-
Set of elements used to provide details of a generic amount for the
statement resource.
items:
description: >-
Set of elements used to provide details of a generic amount for the
statement resource.
type: object
properties:
Amount:
description: Amount of money associated with the amount type.
type: object
properties:
Amount:
type: string
pattern: '^\d{1,13}\.\d{1,5}$'
Currency:
description: >-
A code allocated to a currency by a Maintenance Agency under
an international identification scheme, as described in the
latest edition of the international standard ISO 4217 "Codes
for the representation of currencies and funds".
type: string
pattern: '^[A-Z]{3,3}$'
required:
- Amount
- Currency
additionalProperties: false
CreditDebitIndicator:
type: string
enum:
- Credit
- Debit
description: >-
Indicates whether the amount is a credit or a debit.
Usage: A zero amount is considered to be a credit amount.
Type:
description: 'Amount type, in a coded form.'
type: string
enum:
- ArrearsClosingBalance
- AvailableBalance
- AverageBalanceWhenInCredit
- AverageBalanceWhenInDebit
- AverageDailyBalance
- BalanceTransferClosingBalance
- CashClosingBalance
- ClosingBalance
- CreditLimit
- CurrentPayment
- DirectDebitPaymentDue
- MinimumPaymentDue
- PreviousClosingBalance
- PreviousPayment
- PurchaseClosingBalance
- StartingBalance
- TotalAdjustments
- TotalCashAdvances
- TotalCharges
- TotalCredits
- TotalDebits
- TotalPurchases
required:
- Amount
- CreditDebitIndicator
- Type
additionalProperties: false
required:
- AccountId
- Type
- StartDateTime
- EndDateTime
- CreationDateTime
additionalProperties: false
BECSRemittance:
type: object
description: >-
Unique reference, as assigned by the creditor, to
unambiguously refer to the payment transaction.
Usage: If available, the initiating party should
provide this reference in the structured remittance
information, to enable reconciliation by the
creditor upon receipt of the amount of money. If the
business context requires the use of a creditor
reference or a payment remit identification, and
only one identifier can be passed through the
end-to-end chain, the creditor's reference or
payment remittance identification should be quoted
in the end-to-end transaction identification.
NZ - Remittance information for use with BECS Electronic Credit payment scheme.
The Particulars, Code and Reference fields are currently constrained by
providers. The design choice has been made not to constrain through schema
restrictions, to allow for future changes that remove the constraint.
Note that not all banks will accept all valid characters, in which case a
descriptive 400 Bad Request will be returned. Constraining to a-z, A-Z, -
(dash) and 0-9 is advised. One example is abc-XYZ-123
properties:
CreditorName:
type: string
maxLength: 20
CreditorReference:
type: object
properties:
Particulars:
type: string
maxLength: 12
Code:
type: string
maxLength: 12
Reference:
type: string
maxLength: 12
DebtorName:
type: string
maxLength: 20
DebtorReference:
type: object
properties:
Particulars:
type: string
maxLength: 12
Code:
type: string
maxLength: 12
Reference:
type: string
maxLength: 12
required:
- CreditorName
additionalProperties: false
Meta:
title: MetaData
type: object
description: Meta Data relevant to the payload
properties:
TotalPages:
type: integer
format: int32
FirstAvailableDateTime:
description: >-
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An example is
below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
LastAvailableDateTime:
description: >-
All dates in the JSON payloads are represented in ISO 8601 date-time
format.
All date-time fields in responses must include the timezone. An example is
below:
2017-04-05T10:43:07+00:00
type: string
format: date-time
additionalProperties: false
securityDefinitions:
CustomerOAuth2Security:
type: oauth2
flow: accessCode
tokenUrl: 'https://authserver.example/token'
authorizationUrl: 'https://authserver.example/authorization'
scopes:
accounts: Ability to read accounts information
description: >-
OAuth flow, it is required when the Customer needs to perform SCA with the
API Provider when a Third Party wants to access an API Provider resource owned
by the Customer
ThirdPartyOAuth2Security:
type: oauth2
flow: application
tokenUrl: 'https://authserver.example/token'
scopes:
accounts: Ability to read accounts information
description: >-
Third Party client credential authorisation flow with the API Provider
responses:
400ErrorResponse:
description: Bad Request
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
schema:
$ref: '#/definitions/ErrorResponse'
401ErrorResponse:
description: Unauthorized
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
403ErrorResponse:
description: Forbidden
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
schema:
$ref: '#/definitions/ErrorResponse'
405ErrorResponse:
description: Method Not Allowed
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
406ErrorResponse:
description: Not Acceptable
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
415ErrorResponse:
description: Unsupported Media Type
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
429ErrorResponse:
description: Too Many Requests
headers:
Retry-After:
description: Number in seconds to wait
type: integer
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
500ErrorResponse:
description: Internal Server Error
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
schema:
$ref: '#/definitions/ErrorResponse'
501ErrorResponse:
description: Not Implemented
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
503ErrorResponse:
description: Service Unavailable
headers:
x-fapi-interaction-id:
type: string
description: An RFC4122 UID used as a correlation id.
schema:
$ref: '#/definitions/ErrorResponse'
You can’t perform that action at this time.