Ana səhifə

This specification describes the ofc data format and details how Microsoft ® Money uses ofc for online home banking and online bill payment features


Yüklə 0.88 Mb.
səhifə11/14
tarix18.07.2016
ölçüsü0.88 Mb.
1   ...   6   7   8   9   10   11   12   13   14

OFC


The OFC record contains the version of the OFC data format used to create the file.

Tag

Description



Opening tag for the OFC record.




Closing tag for the OFC record.

Implementation details on


  1. When using OFC with Microsoft Money 5.0, the should be “2.”

  2. The value for should always be “1252.” This is the code page that should be used to interpret the character data following a tag.

Signon Request


The Signon request is designed to contain information to log the user into a server. This record can also be used to identify the session between client and server.

Tag

Description



Opening tag for the SONRQ record.




Closing tag for the SONRQ record.

Notes on


  1. Money will include data in the NEWPASS element if the user has chosen to change their password.

Signon Response


The Signon response answers the Signon request.

Tag

Description



Opening tag for the SONRS record.




Closing tag for the SONRS record.

Notes on implementing :


  1. SERVICE updates the services supported by the server. The original default SERVICE value is downloaded from the Branding Server. If the server supports both services, then multiple SERVICE elements should be included.

  2. DAYSREQD updates the default days-to-pay value. The original default days-to-pay value is downloaded from the Branding Server.

  3. DAYSWITH updates the default withdrawal value. The original default withdrawal value is downloaded from the Branding Server.

When implementing the SONRS, follow these instructions based on the STATUS value returned:
If STATUS is 0

  1. A STATUS of 0 means that the entire batch of transactions sent from Money were accepted by the server.

  2. Include a date/time value of the server in the DTSERVER element.

  3. Include a new value in the SESSKEY element. Money will send this value to the server on the next call.
If STATUS is 5

  1. A STATUS of 5 means that the bank is asking the user to change their password on the next session with the server.

  2. A STATUS of 5 also means that the entire batch of transactions sent from Money were processed by the server.

  3. Include a date/time value of the server in the DTSERVER element.

  4. Include a new value in the SESSKEY element. Money will send this value to the server on the next call.
If STATUS is 100

  1. A STATUS of 100 means that the server has returned a message for the user in the ERROR element.

  2. The server should not return any other response transactions in the OFC response file. The file should only contain a SONRS. A STATUS of 100 means that the transactions sent in the request file were not processed.

  3. Include a date/time value of the server in the DTSERVER element.

  4. The server should include a message to the user in the ERROR element.

  5. The server should echo the value sent in the SESSKEY element of the Signon request.
If STATUS is 101

  1. STATUS of 101 means that the USERID sent in the Signon request was not valid.

  2. The server should not return any other response transactions in the OFC response file. The file should only contain a SONRS. A STATUS of 101 means that the transactions sent in the request file were not processed.

  3. Include a date/time value of the server in the DTSERVER element.

  4. The server should echo the value sent in the SESSKEY element of the Signon request.
If STATUS is 102

  1. STATUS of 102 means that the USERPASS sent in the Signon request was not valid.

  2. The server should not return any other response transactions in the OFC response file. The file should only contain a SONRS. A STATUS of 102 means that the transactions sent in the request file were not processed.

  3. Include a date/time value of the server in the DTSERVER element.

  4. The server should echo the value sent in the SESSKEY element of the Signon request.
If STATUS is 103

  1. STATUS of 103 means that the SESSKEY sent in the SONRS is not the last or expected session key. Banks who use the SESSKEY as a means of security should use this STATUS code.

  2. The server should not return any other response transactions in the OFC response file. The file should only contain a SONRS. A STATUS of 103 means that the transactions sent in the request file were not processed.

  3. Include a date/time value of the server in the DTSERVER element.

  4. The server should echo the value sent in the SESSKEY element of the Signon request. This will be sent in the Signon request of the next call.

  5. Money will display an error message to the user asking them to contact their bank. It is expected that the bank will reset the user’s SESSKEY on the server such that on the next call the server will accept any SESSKEY and return a new one in the SONRS.
If the user has changed their password

  1. If the server received a NEWPASS in the SONRQ and the user’s password was changed successfully, the server should also send back the following record:



4



Your password has been successfully changed.




If the password was not changed, return the following MEMO in the same record as above:



Your password was not changed.

Chapter 11


Account Records


Account records are used to describe the online services available for a user’s account.

Microsoft Money will send the server an Account request after the user enables or changes the online services for a particular account. The server is expected to return an Account response with the status of the user’s accounts on the server.

Tags displayed in bold are required by Microsoft Money.



1   ...   6   7   8   9   10   11   12   13   14


Verilənlər bazası müəlliflik hüququ ilə müdafiə olunur ©atelim.com 2016
rəhbərliyinə müraciət