Syntch Gateway API

<back to all web services

PatchRegister

Administration - Register Management
Requires Authentication
Requires any of the roles:Merchant, Reseller
The following routes are available for this service:
PATCH/registers/{registerKey}Updates a register for the merchant requester with only the data provided.
PatchRegister Parameters:
NameParameterData TypeRequiredDescription
RegisterKeypathintYesThe key of the custom field to be edited.
ActivationStatusmodelstringNoThe register status.

Allowable Values

  • Pending
  • Active
  • Inactive
  • Deleted
StatusqueryActivationStatus?No
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.

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

<PatchRegister 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>String</ActivationStatus>
  <RegisterKey>0</RegisterKey>
</PatchRegister>
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>