Axsess

The Axsess app is a web experience enhancement utility, intended for websites which process identity documents.

By invoking the app, web driven applications can capture photographs of identity documents, and send the identity documents to web services, before continuing.

The app requires an OCR URL - this supplies the server side OCR functionality associated with the app.

To support the app, the OCR URL must be the root of the following scripts:-

upload.php
Receives a Form encoded MIME multipart HTTP post, with a file named primary, a file named secondary, a text field named comment. This is used with the “Send to Developer” functionality, so users of the app can send documents which malfunction to the server administrator.

The following scripts accept a single JPEG image named “upload”, as a Form encoded MIME multipart HTTP post. They should all return a response of the following structure:-

{“status”: “OK”, “result”: { “KEY1”: { “result”: “<text>”, “candidates”: [“<text>”, “<text>”…]}, “KEY2”: { “result”: “<text>”, “candidates”: [“<text>”, “<text”>…]}}}

For brevity, in the descriptions of the required scripts, only the key names are listed.

medicare.php
This is used when processing Australian medicare cards. This should return the following keys:
NAMES: The ocr best effort to read all the person names on the Medicare card
CARD_NUMBER: The Medicare card number.
EXPIRY_DATE: The Medicare card expiry date.

vicLicense.php
This is used when processing Australian (Victoria) driver’s licenses. This should return the following keys:
LICENSE_NUMBER: The license number
NAME_AND_ADDRESS: The name and address displayed on the license
EXPIRY_DATE: The expiry date of the license
DATE_OF_BIRTH: The date of birth displayed on the license
DATE_OF_BIRTH2: Victorian licenses have 2 different positions which contain the date of birth – this is an attempt to read the second position.

nswLicense.php
This is used when processing Australian (New South Wales) driver’s licenses. This should return the following keys:
LICENSE_NUMBER: The license number
NAME_AND_ADDRESS: The name and address displayed on the license
EXPIRY_DATE: The expiry date of the license
DATE_OF_BIRTH: The date of birth displayed on the license
CARD_NUMBER: New South Wales licenses have a separate card number, in addition to the license number.

passport.php
This is used when processing Australian Passports. This should return the following keys:
NAME – The person’s name
PASSPORT_NUMBER – The passport number
DATE_OF_BIRTH – The date of birth on the passport
BIRTH_PLACE – The name of the place of birth on the passport
EXPIRY_DATE – The expiry date of the passport

validateAddress.php
This is used to perform additional validation on OCR addresses. The following fields are expected, as HTTP Post parameters:
address: The address to be validated
state: The state of the address
The validateAddress.php script should return a JSON string of the following format:
{“status”: “OK”, “address”: “<the validated address>”}

The Complete the Form function expects a server to export a SOAP service conforming to the interface below:

http://ocrtest.appmanager.com.au/wsdl.xml

The URL of the SOAP interface is supplied as part of the app scheme URL which invokes the App.

Invoking the App can be performed via an app scheme URL with the following format:-

axsocr20121230://identifier=<identifier>&returnaddress=<return_address>&soapService=<soap_service>

<identifier> is a web page supplied identifier used to track the transaction.
<return address> is the http:// page which should be opened when the app has finished processing the IDs.
<soap_service> is the address of the soap service which conforms to the WSDL protocol specified above.