Force Update a PIN Entry Device

In this section you will learn how to process a Force Update Ped message

Force Update on a PIN Entry Device Overview

A Force PED Update enables the merchant to request an update to the PIN Entry Device. Section ForceUpdatePedRequest Element describes the elements required to build a ForcePedUpdate message.

How to process a ForceUpdatePedRequest message

The merchant's system sends a ForceUpdatePedRequest message to ANYpay POS to invoke an update on the PIN Entry Device based on the terminal packages downloaded from the ANYpay Gateway.

❗️

A Force Update PED request message will overwrite all terminal packages on the PIN Entry Device that have been requested.

Section ForceUpdatePedRequest Element describes the elements required to build a ForceUpdatePedRequest message.

An ForceUpdatePedRequest message is shown in the following example

<ForceUpdatePedRequest xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                       xmlns="http://servebase.com/2009/06/pedframework">
  <PedEndpointAddress>
    <EndpointAddressType>Serial</EndpointAddressType>
    <SerialEndpointAddress>
      <ComPort>com9</ComPort>
    </SerialEndpointAddress>
  </PedEndpointAddress>
  <TransactionConfig>
    <CustomerCode>ANF</CustomerCode>
    <Site>ANF000000001</Site>
    <Culture>en</Culture>
    <Workstation>001</Workstation>
    <MerchantId>1234567</MerchantId>
    <Username>ANFUser</Username>
    <Password>-T5g_GoH</Password>
    <IpAddress>127.0.0.1</IpAddress>
  </TransactionConfig>  
  <Reference>7ACBBA79-F0FB-421C-983B-48F94907E714</Reference>
</ForceUpdatePedRequest>

Handling a ForceUpdatePedResponse message

Section ForcePedUpdateResponse Element describes the elements that are returned in a ForcePedUpdateResponse message.

An example of an ForcePedUpdateResponse message is shown in the following example

<ForceUpdatePedResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                        xmlns:xsd="http://www.w3.org/2001/XMLSchema"
                        xmlns="http://servebase.com/2009/06/pedframework">
  <ResponseCode>Success</ResponseCode>
  <ResponseMessage>Update Complete</ResponseMessage>
  <FaultResponseCode>0</FaultResponseCode>
  <Reference>7ACBBA79-F0FB-421C-983B-48F94907E714</Reference>
  <SerialNumber>303-832-259</SerialNumber>    
</ForceUpdatePedResponse>