Syntch Gateway API

<back to all web services

PutRegister

Administration - Register Management
Requires Authentication
Requires any of the roles:Merchant, Reseller
The following routes are available for this service:
PUT/registers/{registerKey}Updates a single register for the merchant requester by updating all fields to match the request (effectively, this replaces the resource, see PATCH to edit individual values). Please supply all values.
PutRegister Parameters:
NameParameterData TypeRequiredDescription
RegisterKeypathintYesThe key of the register to be edited.
ActivationStatusmodelActivationStatus?YesThe register status.

Allowable Values

  • Pending
  • Active
  • Inactive
  • Deleted
ModifyRegister<T> Parameters:
NameParameterData TypeRequiredDescription
RegisterNamemodelstringNoThe register name.
TerminalNumbermodelstringNoThe terminal number.
TerminalNumber2modelstringNoThe second terminal number.
ProcessorIdmodelstringYesThe processor ID.
ActivationStatus Enum:
Pending
Active
Inactive
Deleted
RegisterDetail Parameters:
NameParameterData TypeRequiredDescription
RegisterKeymodelintNoThe unique identifier for this register.
MerchantKeymodelint?NoThe key of the merchant that is associated with this register.
RegisterNumbermodelstringNoThe number of the register.
RegisterNamemodelstringNoThe name of the register.
TerminalNumbermodelstringNoThe primary terminal number for the register.
TerminalNumber2modelstringNoAn additional terminal number for the register.
ProcessorIdmodelstringNoIndicates the processor used by the register.
ActivationStatusmodelActivationStatus?NoIndicates the current activation status of the record.
LastUpdateTimestampmodelDateTimeNoIndicates when the register was last edited.

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

PUT /registers/{registerKey} HTTP/1.1 
Host: syntch.simpay.net 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<PutRegister xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Gateway.RestApi.Registers.Requests">
  <ProcessorId>String</ProcessorId>
  <RegisterName>String</RegisterName>
  <TerminalNumber>String</TerminalNumber>
  <TerminalNumber2>String</TerminalNumber2>
  <ActivationStatus>Pending</ActivationStatus>
  <RegisterKey>0</RegisterKey>
</PutRegister>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<RegisterDetail xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Gateway.RestApi.Registers.Responses">
  <ActivationStatus>Pending</ActivationStatus>
  <LastUpdateTimestamp>0001-01-01T00:00:00</LastUpdateTimestamp>
  <MerchantKey>0</MerchantKey>
  <ProcessorId>String</ProcessorId>
  <RegisterKey>0</RegisterKey>
  <RegisterName>String</RegisterName>
  <RegisterNumber>String</RegisterNumber>
  <TerminalNumber>String</TerminalNumber>
  <TerminalNumber2>String</TerminalNumber2>
</RegisterDetail>