Update card details of a User with the USB card reader

updateCard(p_companyID, p_wsAltUserId , p_usbCardId)

 

You can use this endpoint to update (add/delete) card details of one User from our database.

Parameters

Name Type Required Description
p_companyID string Yes The security code you have been provided with, string (32)
p_wsAltUserId string Yes The wsAltUserId of the User from the EasySecure database (the id of the User from the 3rd party application)
p_usbCardId string Yes The decimal value as read by the USB card reader


NOTE*:
To delete the card details from a User, the p_usbCardId must be sent as an empty string

Return values

'ERROR_NO_SECURITY_HASH' - p_companyID not provided

'ERROR_UNKNOWN_SECURITY_HASH' - p_companyID is incorrect, no Company can be identified

'NO_WS_ALT_USER_ID_INFOFIELD_SET' - Company setup is incorrect, there is no info label with info label function wsAltUserId

'NO_ID_RECEIVED' - p_wsAltUserId not provided

'CAN_NOT_SAVE_USER' - can not save the User in our database

'CARD_NOT_SUPPORTED' - the card is not supported in EasySecure yet

'CARD_NOT_VALID' - there is a problem with the card, not supported in EasySecure yet

'CARD_EXISTS_FOR_AN_OTHER_USER' - the card is already linked to another User in EasySecure

'NO_USER_FOUND_WITH_WSALTUSERID' - we can not identify a User in EasyConnect with the given p_wsAltUserId

'NO_INFO_FOUND_WITH_WSALTUSERID' - we can not identify a User in EasyConnect with the given p_wsAltUserId

'OK' - the user details regarding his card have been updated.

Sample

<soapenv:Header/>
<soapenv:Body>
123
2
036136500607727109
</uen:Esws.updateCard>
</soapenv:Body>
</soapenv:Envelope>

Response

<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:Esws.updateCardResponse xmlns:ns1="uen:esws">
<return xsi:type="xsd:string">OK</return>
</ns1:Esws.updateCardResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>