Syntch Gateway API

<back to all web services

GetOpenAuthorizations

Reporting - Open Authorizations
Requires Authentication
Requires any of the roles:Reseller, Merchant
The following routes are available for this service:
GET/reports/openauthorizations/Get a list of open authorization transactions.
GetOpenAuthorizations Parameters:
NameParameterData TypeRequiredDescription
BeginDatequerystringYesBeginning date of the open authorization query (defaults to 7 days ago).
EndDatequerystringNoEnd date of the open authorization query (defaults to 'now').
TransactionIdqueryintNoFilter by TransactionId.
UsernamequerystringNoFilter by Username.
PaymentTypequeryList<string>NoFilter by PaymentType.

Allowable Values

  • CREDIT
  • VISA
  • DINERS
  • AMEX
  • MASTERCARD
  • JAL
  • JCB
  • DISCOVER
  • CARTEBLANCHE
  • EBT
  • DEBIT
  • ECG
  • VERIFY
  • ECHECK
ProcessorIDquerystringNoFilter by processor.
CardHolderNamequerystringNoFilter by card holder name.
AuthorizedAmountquerydecimal?NoFilter by AuthAmount.
SortFieldquerystringNoThe field name by which the records will be sorted. Default is 'Timestamp'.

Allowable Values

  • TransactionId
  • TransactionTimestamp
  • Username
  • PaymentType
  • CardHolderName
  • ProcessorID
  • AuthorizedAmount
SortedRequestDto Parameters:
NameParameterData TypeRequiredDescription
SortDirectionquerystringNoThe direction in which the records will be sorted. Default is 'asc'.

Allowable Values

  • Asc
  • Desc
SortFieldquerystringNoThe field name by which the records will be sorted.
PaginatedRequestDto Parameters:
NameParameterData TypeRequiredDescription
PageSizequeryshortNoThe number of records per page. Default is 20.
PageNumberqueryshortNoThe page number to fetch. Default is 1.
OpenAuthorizationResults Parameters:
NameParameterData TypeRequiredDescription
OpenAuthorizationsmodelList<OpenAuthorizationTransaction>NoA collection of open authorizations.
PaginationmodelPaginationStatsNoPagination stats regarding the result set.
OpenAuthorizationTransaction Parameters:
NameParameterData TypeRequiredDescription
TransactionIdmodelintNoThe Transaction Id (unique gateway identifier) of the transaction.
InvoiceNumberformstringNo
TransactionTypeformstringNo
TransactionTimestampformstringNo
MerchantKeyformstringNo
UsernameformstringNo
ResellerKeyformintNo
PaymentTypeformstringNo
ProcessorIDformstringNo
AuthorizedAmountformstringNo
ResultCodeformstringNo
AuthorizationCodeformstringNo
HostReferenceNumberformstringNo
ServiceformstringNo
AccountLast4formstringNo
CardHolderNameformstringNo
ExpirationDateformstringNo
ResultTextformstringNo
ResellerNameformstringNo
MerchantNameformstringNo
PaginationStats Parameters:
NameParameterData TypeRequiredDescription
CurrentPageNumberformintNo
PageSizeformintNo
TotalRecordCountformintNo

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

HTTP + JSV

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

GET /reports/openauthorizations/ HTTP/1.1 
Host: syntch.simpay.net 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	OpenAuthorizations: 
	[
		{
			TransactionId: 0,
			InvoiceNumber: String,
			TransactionType: String,
			TransactionTimestamp: String,
			MerchantKey: String,
			Username: String,
			ResellerKey: 0,
			PaymentType: String,
			ProcessorID: String,
			AuthorizedAmount: String,
			ResultCode: String,
			AuthorizationCode: String,
			HostReferenceNumber: String,
			Service: String,
			AccountLast4: String,
			CardHolderName: String,
			ExpirationDate: String,
			ResultText: String,
			ResellerName: String,
			MerchantName: String
		}
	],
	Pagination: 
	{
		CurrentPageNumber: 0,
		PageSize: 0,
		TotalRecordCount: 0
	}
}