getRegistrationPin

Retrieve a device registration pin

Description

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:

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

Syntax

string getRegistrationPin ( ueSecurityToken Token)

Arguments

Type	Name	Description
ueSecurityToken	Token	Merchant security token: used to identify merchant and retrieve the custom fields.

Return Value

string

Device registration pin

Exceptions

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

Code

Message

Advice

Examples

PHP

VB

.NET C#

XML

Request:

<?xml version="1.0" encoding="UTF-8"?>

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="https://secure.eBizCharge.com/soap/2.0/uedocs">

<SOAP-ENV:Body>

<ns1:getRegistrationPin>

<Token>

</PinHash>

<SourceKey>e42SYc86C4uvlvyP62ow54Kv93SZsJVm</SourceKey>

</Token>

</ns1:getRegistrationPin>

</SOAP-ENV:Body>

</SOAP-ENV:Envelope>

Response: