Banking Services, Queries and Alerts

The Sample Server provides the following banking services. You can use the adapter service template to create adapter service nodes that use these services:

Service Name	Description
Deposit	Creates multiple cash and check deposits. When the check number is equal to or less than 0, the deposit is considered to be a cash deposit.
Bounce Check	Bounces (disapproves) a check deposit.
Clear Check	Clears (approves) a check deposit.
Get Balance	Retrieves the current balance of the specified account.
Get History	Retrieves the service history of the specified account.
Transfer	Transfers funds between two accounts. The user ID and Personal Identification Number (PIN) are authenticated against both accounts.
Withdraw	Withdraws funds from the specified account. A negative amount cannot be withdrawn.

Banking event queries retrieve information about specific activities that occur in the Sample Server as a result of banking service requests. Each occurrence of a banking event is returned only once. The Sample Server uses polling notifications to retrieve these events and to generate notification documents.

Event Query	Description
CheckDepositStatusChange	Requests a list of checks that have cleared or bounced since the last time the query was made. These events occur as a result of the Clear Check or Bounce Check services.
UnderBalance	Requests a list of accounts that have been overdrawn since the last time the query was made. These events occur as a result of Withdraw or Transfer services that result in a negative account balance. Note: The Withdraw or Transfer service request is successful if the request had been rejected because the debit exceeded the account's credit limit. In this case, no UnderBalance event is recorded.

Note:
The Sample Server client cannot acknowledge the polling message from the receiving side as no protocol support exists. Consequently a document is not published with the same message twice. For example, if a document reports that an account has fallen to -10, no other document is published until the amount changes.

Banking alerts are generated when specified events occur on the Sample Server. Unlike banking event queries, banking alerts are generated and delivered in real time to a configured address. The Sample Adapter implements listeners to monitor these addresses and to retrieve the alert data. Listener notifications are then used to distribute the alert information to Integration Server services. There is no queuing mechanism for alerts, so if no listener is ready to retrieve the alert data, it will be lost.

Alerts	Description
CheckDepositNotification	Generated for each check that is successfully deposited with the Deposit service.
UnderBalanceNotification	Generated for each Withdraw or Transfer service that results in a negative account balance. This alert is identical to the UnderBalance banking event, but is delivered as an alert.