Balance Account Request (PIISP)

In case of PIISP there are validation of certificate and client.

The response sends information about the account balance in the YES / NO answer (there is/is not enough funds on the account).

PIISP processes visualization

Picture: Balance Check Flow


POST BalanceCheck

Method of service: HTTP POST

Access Token is possible obtain as 90AT or Token by Secret.

Request structure:

Attributes structure
Optionality
Type
Description
Level 1
Level 2
Level 3
instruction Identification
Mandatory
String
Technical identification of payment generated by the PIISP
creation DateTime
Optional
DateTime
The date and time in RFC3339 format at which a particular action has been requested or executed.
iban
Mandatory
String [34]
International Bank Account Number (IBAN)
amount
value
Mandatory
Number Float [12.2]
Transaction amount value. Numeric value of the amount as a fractional number
amount
currency
Mandatory
String [3]
Transaction amount currency. Formatted in Alphabetic codes from ISO 4712.
relatedParties
tradingParty
identification
Optional
String [35]
Unique identification of a third party. For card transaction, this is ID of merchant.
relatedParties
tradingParty
name
Optional
String [140]
Name of a third party. For card transaction, this is the name of merchant.
relatedParties
tradingParty
address
Optional
String [70]
Merchant cumulative address identification usually containing concatenation of street name, street number, etc.
relatedParties
tradingParty
countryCode
Optional
String [2]
The two-letter merchant country code adopted from ISO3166.
related Parties
trading Party
merchant Code
Optional
String [4]
A Merchant Category Code (MCC) coordinated by MasterCard and Visa.
references
cheque Number
Optional
String [35]
For card transactions, this is the card number in format **** **** **** 1111
references
holderName
Optional
String [35]
Card holder name


Response structure:

Level 1
Optionality
Type
Description
response
Mandatory
Enum
Response is enumeration: - APPR (sufficient funds on the account) - DECL (insufficient funds in the account)
dateTime
Mandatory
DateTime
The date and time in RFC3339 format at which a particular action has been requested or executed.