Retrieve a device registration pin

For integrated software (point of sale solution) to use the gateway driven point of sale devices, the device must be paired with the source key. This can be done using the merchant's web console by going to Settings - POS Devices or the point of sale system can facilitate the pairing.

The steps for device pairing are:

1. Power up pin pad device and verify proper network connectivity
2. If successful, the pos device will display prompt for pin
3. Point of sale software makes call to getRegistrationPin which will return pin
4. Point of sale displays pin to user
5. User enters pin into pos device
6. Pos device will display idle screen and pos software can start using device methods

string getRegistrationPin ( ueSecurityToken Token)

The following exceptions (errors) are applicable to this method.

For directions on how to set up the WSDL link, create “$token” and “$client”, go to PHP Soap How-to.

Request:

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://www.usaepay.com/soap/2.0/uedocs">
<SOAP-ENV:Body>
<ns1:getRegistrationPin>
<Token>
<ClientIP>192.168.0.1</ClientIP>
<PinHash>
<HashValue>c49a67564d2f62e97507c05fa9f68135c139d362</HashValue>
<Seed>13651026722014578962</Seed>
<Type>sha1</Type>
</PinHash>
<SourceKey>e42SYc86C4uvlvyP62ow54Kv93SZsJVm</SourceKey>
</Token>
</ns1:getRegistrationPin>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Response: