API Documentation

Base URL: /JSON/TransactionService.svc, Version: 2.0.1

Build something great with the payment Industries Simplest API!

Once you've registered it's easy to start querying our api.

Our production endpoints are only accessible via https and are located at payx1.com/JSON/TransactionService.svc

Please make sure your HTTP client supports SNI (Server Name Indication).

Query parameters

Each query accepts the 4 authentication parameters : username, password, apikey and devicecode.

username : This is the username of the current user. You can manage your users via our website here.

password : Corresponding password for the provided username. This field is not required and is only used to perform an additional security check.

apikey : This is your API Key. You can view your API keys here.

devicecode : Leave this field blank if you'll be using only 1 device, otherwise if you wish to manage seperate devices for reporting use you can manage additional devices here.

Default response content-types: application/json

Schemes: https

Summary

Path	Operation	Description
/AddCardToVault	GET	Adds the card to the card vault. Card can then be processed by calling /CardVaultTransaction
/CardVaultTransaction	GET	Perform card vault transaction.
/CreateRecurringBilling	GET	Before creating a recurring billing rule you must add a card to the card vault and keep the original transaction id. EveryDay = 54, EveryWeek = 38, Every_2_Weeks = 40, Every_3_Weeks = 42, Every_4_Weeks = 43, Every_5_Weeks = 44, Every_6_Weeks = 45, EveryMonth = 49, Every_2_Months = 50, Every_3_Months = 91, Every_6_Months = 92, Every_12_Month = 93
/ReprintRecurringBilling	GET	Get a recurring billing information using the identifier field or the recurringBillingId field.
/DeleteRecurringBilling	GET	Delete a previously created recurring billing.
/CreditTransaction	GET	Perform credit card transaction.
/CreateTransaction	GET	Process Credit or ACH transaction.
/Capture	GET	Capture a previously authorized transaction
/GetAssociatedTransactions	GET	Get all transactions associated to the given preTransaction.
/GetLastCreditTransaction	GET	Gets the last credit transaction.
/GetPrice	GET	Gets the price for the current device.
/GetSurcharge	GET	Get the surcharge amount.
/PreTransaction	GET	Saves pre transaction information for future payment. User will have to keep UniqueId in his records to process this transaction in the future. The user can activate the recurring billing option and the system will automatically bill the customer basing on the given frequency.
/GetTransactions	GET	Get transaction history and details.
/ProcessPreTransaction	GET	Process a pre transaction via API calls. Otherwise hosted payment page is available at : /Payment?preTransact={UniqueId}
/ReprintCredit	GET	Get credit transaction information for given transaction id.
/ReprintCreditByReferenceNumber	GET	Get credit transaction information for given PNRef.
/ReSendInvoice	GET	Send the payment confirmation and get the transaction.
/ReturnTransaction	GET	Refund a previously settled transaction (possible to refund only a part of the transaction by specifying an amount)
/ReturnTransactionByReferenceNumber	GET	Refund a previously settled transaction using the PNRef (possible to refund only a part of the transaction by specifying an amount)
/UpdateCardInVault	GET	Updates card vault information
/UpdateTransaction	GET	Updates an existing transaction information
/ValidateCredentials	GET	Validates if the entered credentials are valid for performing any action with the API.
/VoidTransaction	GET	Void a previously unsettled transaction (usually wihtin the same day)
/ValidateCard	GET	Validate a credit card number
/RegisterWebHooks	GET	Register your webhook.
/DeactivateWebHooks	GET	Deactivate your webhook

Paths

Adds the card to the card vault. Card can then be processed by calling /CardVaultTransaction

GET /AddCardToVault


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
name	Cardholder Name	query	string
streetaddress	Street Adress	query	string
city	City	query	string
state	State	query	string
zipcode	Zip Code	query	string
cardnumber	Card Number	query	string
expdate	Expiration Date (MMYY)	query	string
cvv	CVV Code	query	string
email	Email	query	string
gatewaycode	Payment processor identifier, available on the location webpage	query	integer

Uses default content-types: application/json

200 OK: Successful response

CreditTransactionResponse
400 Bad Request: Error response

ErrorResponse

Perform card vault transaction.

GET /CardVaultTransaction


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
amount	Transaction amount. Format: Number with 2 decimals places	query	decimal
transactionId	/AddToCardVault transaction Id	query	integer (int64)
invoice	Invoice number (if applicable)	query	string
paymentType	33 = InitialDeposit, 34 = AdditionalDeposit, 35 = FinalPayment	query	integer (int64)
gatewayCode	Payment processor identifier, available on the location webpage. Availble only for gateways that support network tokenization.	query	integer (int64)
surchargeidentifier	The surcharge identifier returned by /GetSurcharge. If the amount is different to the surcharge reference amount the transaction will be declined.	query	string
requestSurcharge	Transaction fees will be calculated and added to the amount if set to true.	boolean	boolean
customFields	JSON array of TransactionCustomField	query	String

Uses default content-types: application/json

200 OK: Successful response

CreditTransactionResponse
400 Bad Request: Error response

ErrorResponse

Before creating a recurring billing rule you must add a card to the card vault and keep the original transaction id. EveryDay = 54, EveryWeek = 38, Every_2_Weeks = 40, Every_3_Weeks = 42, Every_4_Weeks = 43, Every_5_Weeks = 44, Every_6_Weeks = 45, EveryMonth = 49, Every_2_Months = 50, Every_3_Months = 91, Every_6_Months = 92, Every_12_Month = 93

GET /CreateRecurringBilling


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
transactionId	TransactionId of the card vault transaction	query	string
amount	Transaction amount. Format: Number with 2 decimals places	query	decimal
frequency	View possible values in query description	query	integer (int64)
beginDate	Recurring billing starting on (in "yyyy-MM-dd" format)	query	string
endDate	Recurring billing ending on (in "yyyy-MM-dd" format)	query	string
deactivateSurcharge	Surcharging won't be applied. (The user must have the required permission)	query	boolean

Uses default content-types: application/json

200 OK: Successful response

CreateRecurringResponse
400 Bad Request: Error response

ErrorResponse

Get a recurring billing information using the identifier field or the recurringBillingId field.

GET /ReprintRecurringBIlling


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
identifier	Recurring billing identifier. The field is required only if the recurringBillingId is not provided.	query	string
recurringBillingId	Recurring billing Id. The field is required only if the identifier is not provided.	query	number (int64)

Uses default content-types: application/json

200 OK: Successful response

CreateRecurringResponse
400 Bad Request: Error response

ErrorResponse

Delete a previously created recurring billing.

GET /DeleteRecurringBilling


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
identifier	The recurring billing identifier	query	string

Uses default content-types: application/json

200 OK: Successful response

DeleteRecurringBillingResponse
400 Bad Request: Error response

ErrorResponse

Perform credit card transaction.

GET /CreditTransaction


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
amount	Transaction amount. Format: Number with 2 decimals places	query	decimal
name	Cardholder Name	query	string
invoice	Invoice number (if applicable)	query	string
streetaddress	Street Adress	query	string
city	City	query	string
state	State	query	string
zipcode	Zip Code	query	string
cardnumber	Card Number	query	string
expdate	Expiration Date (MMYY)	query	string
cvv	CVV Code	query	string
email	Email	query	string
secureFormat	secureFormat	query	string
tax	tax	query	string
gatewaycode	Payment processor identifier, available on the location webpage	query	integer
surchargeIdentifier	The surcharge identifier returned by /GetSurcharge. If the amount is different to the surcharge reference amount the transaction will be declined.	query	String
customFields	JSON array of TransactionCustomField	query	String
transactionType	TransactionType Enum If the value is not submitted, the transaction will be captured.	query	int
shippingCountryCode	The shipping country code (ISO 3166-1 alpha-2 code)	query	string
shippingStateCode	Shpping address state code	query	string
shippingZipCode	Shipping Zipcode / Postal code	query	string
shippingCity	Shipping city	query	string
shippingStreet	Shipping street address	query	string
shippingFirstName	Shipping First name	query	string
shippingLastName	Shipping Last name	query	string
duty	Duty amount if applied. Format: Number with 2 decimals places	query	decimal
shippingHandling	Additional shipping amount. Format: Number with 2 decimals places	query	decimal
products	JSON array of TransactionProducts	query	string
customerVAT	Customer VAT number	query	string

Uses default content-types: application/json

200 OK: Successful response

CreditTransactionResponse
400 Bad Request: Error response

ErrorResponse

Perform an ACH or a credit Transaction.

GET /CreateTransaction


username	Username	query	string
password	Password	query	string
ApiKey	ApiKey	query	string
Devicecode	Devicecode	query	string
Amount	Transaction amount. Format: Number with 2 decimals places	query	decimal
gatewaycode	Payment processor code	query	string
paymentmode	Credit payment or ACH payment.	query	PaymentModeEnum
name	name	query	string
streetaddress	streetaddress	query	string
city	city	query	string
zipcode	zipcode	query	string
title	title	query	string
PO	purchase order number	query	string
bankRouting	The bank routing number.	query	string	For ACH transactions
accountNumber	Account Number	query	string	For ACH transactions
socialSecurityNumber	Social Security Number	query	string
driverLicenseNumber	Driver License Number	query	string
yearOfBirth	Year of birth (4 digits format YYYY)	query	string
email	User email	query	string
customFields	JSON array of TransactionCustomField	query	string
cardnumber	cardnumber.	query	string
expdate	expdate.	query	string
cvv	cvv.	query	string
transactionType	TransactionType Enum If the value is not submitted, the transaction will be captured.	query	int
shippingCountryCode	The shipping country code (ISO 3166-1 alpha-2 code)	query	string
shippingStateCode	Shpping address state code	query	string
shippingZipCode	Shipping Zipcode / Postal code	query	string
shippingCity	Shipping city	query	string
shippingStreet	Shipping street address	query	string
shippingFirstName	Shipping First name	query	string
ShippingLastName	Shipping Last name	query	string
duty	Duty amount if applied. Format: Number with 2 decimals places	query	decimal
shippingHandling	Additional shipping amount. Format: Number with 2 decimals places	query	decimal
products	JSON array of TransactionProducts	query	string
customerVAT	Customer VAT number	query	string

Uses default content-types: application/json

200 OK: Successful response

TransactionResponse
400 Bad Request: Error response

ErrorResponse

Capture a previously authorized transaction.

GET /Capture


APIUn	Your API username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
TransactionId		query	Int64
Amount	Amount to capture. If not sent the total amount will be captured. Format: Number with 2 decimals places	query	decimal

Uses default content-types: application/json

200 OK: Successful response

CreditTransactionResponse
400 Bad Request: Error response

ErrorResponse

Gets the last credit transaction.

GET /GetLastCreditTransaction


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string

Uses default content-types: application/json

200 OK: Successful response

CreditTransactionResponse
400 Bad Request: Error response

ErrorResponse

Get the surcharge amount.

GET /GetSurcharge


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
gatewayCode	Payment processor identifier, available on the location webpage	query	number (double)
amount	Transaction amount. Format: Number with 2 decimals places	query	decimal
cardnumber	The credit card number. This parameter is required if the transactionId is not supplied.	query	integer (int64)
transactionId	transactionId representing an already tokenized card. This parameter is required if the cardnumber is not supplied.	query	integer (int64)
invoice	Invoice number	query	string
country	The ISO country code	query	integer (int64)
region	Transaction ZipCode	query	integer (int64)

Uses default content-types: application/json

200 OK: Successful response

SurchargeResponse
400 Bad Request: Error response

ErrorResponse

Gets the price for the current device.

GET /GetPrice


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string

Uses default content-types: application/json

200 OK: Successful response

GetPriceResponse
400 Bad Request: Error response

ErrorResponse

Saves pre transaction information for future payment. User will have to keep UniqueId in his records to process this transaction in the future.

GET /PreTransaction


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
amount	Transaction amount. Format: Number with 2 decimals places	query	decimal
name	Cardholder Name	query	string
autoDeactivate	The preTransaction will be deactivated after a payment.	query	boolean
invoice	Invoice number (if applicable)	query	string
PoNumber	Purchase order (if applicable)	query	string
streetaddress	Street Adress	query	string
city	City	query	string
state	State	query	string
zipcode	Zip Code	query	string
CountryCode	Billing country code	query	string
email	Email	query	string
successurl	Where the customer will be redirected after a successfull transaction	query	string
failurl	Where the customer will be redirected in case of an invalid transaction	query	string
cancelURL	Cancel button url	query	string
gatewaycode	Payment processor identifier, available on the location webpage	query	integer
customFields	JSON array of TransactionCustomField	query	string
paymentmode	Available payment mode on checkout. Credit (58) is the default value.	query	PaymentModeEnum
billingFirstname	Billing Firstname	query	string
billingLastname	Billing Firstname	query	string
shippingCountryCode	The shipping country code (ISO 3166-1 alpha-2 code)	query	string
shippingStateCode	Shpping address state code	query	string
shippingZipCode	Shipping Zipcode / Postal code	query	string
shippingCity	Shipping city	query	string
shippingStreet	Shipping street address	query	string
shippingFirstName	Shipping First name	query	string
shippingLastName	Shipping Last name	query	string
duty	Duty amount if applied. Format: Number with 2 decimals places	query	decimal
shippingHandling	Additional shipping amount. Format: Number with 2 decimals places	query	decimal
products	JSON array of TransactionProducts	query	string
customerVAT	Customer VAT number	query	string
easyCheckout	A simple checkout page with the just account fields displayed to your customer when set to true.	query	boolean
createRecurringBilling	A recurring billing will be created.	query	boolean
beginDate	Recurring billing starting on (in "yyyy-MM-dd" format). Need to be specified only if the parameter startAfterFirstCheckout is set to false.	query	string
EndDate	Recurring billing ending on (in "yyyy-MM-dd" format).	query	string
startAfterFirstCheckout	The recurring billing will automatically start after the first checkout.	query	boolean
frequency	The recuring billing frequency.	query	Frequency
storeOnly	The card will be stored for future transactions if set to true.	query	boolean
authOnly	The transaction amount will be sent for authorization only. The default value is false.	query	boolean

Uses default content-types: application/json

200 OK: Successful response

PreTransactionResponse
400 Bad Request: Error response

ErrorResponse

Returns all transactions associated to a given preTransaction.

GET /GetAssociatedTransactions


username	Username	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
uniqueId	Pretransaction uniqueId	query	string

Uses default content-types: application/json

200 OK: Successful response

BatchTransactionResponse
400 Bad Request: Error response

ErrorResponse

Returns all transactions.

GET /GetTransactions


username	Username	query	string
apikey	API Key	query	string
devicecode	Device Code	query	string
startDate		query	string format of the dateTime in UTC (Format: yyyy-MM-ddTH:mm:ss)
endDate		query	string format of the dateTime in UTC (Format: yyyy-MM-ddTH:mm:ss)
pageSize		query	Page size
pageNumber		query	Page number

Uses default content-types: application/json

200 OK: Successful response

BatchTransactionResponse
400 Bad Request: Error response

ErrorResponse

Process a pre transaction via API calls. Otherwise hosted payment page is available at : /Payment?preTransact={UniqueId}

GET /ProcessPreTransaction


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
uniqueid	UniqueId of pre transaction to process	query	string
amount	Transaction amount. Format: Number with 2 decimals places	query	decimal
name	Cardholder Name	query	string
invoice	Invoice number (if applicable)	query	string
streetaddress	Street Adress	query	string
city	City	query	string
state	State	query	string
zipcode	Zip Code	query	string
cardnumber	Card Number	query	string
expdate	Expiration Date (MMYY)	query	string
cvv	CVV Code	query	string
email	Email	query	string

Uses default content-types: application/json

200 OK: Successful response

CreditTransactionResponse
400 Bad Request: Error response

ErrorResponse

Get credit transaction information for given transaction id.

GET /ReprintCredit


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
transactionid	Transaction Id	query	string

Uses default content-types: application/json

200 OK: Successful response

CreditTransactionResponse
400 Bad Request: Error response

ErrorResponse

Get credit transaction information for given PNRef.

GET /ReprintCreditByReferenceNumber


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
PNRef	Transaction PNRef	query	string

Uses default content-types: application/json

200 OK: Successful response

CreditTransactionResponse
400 Bad Request: Error response

ErrorResponse

Send the payment confirmation e-mail anf get the transaction information for given transaction id.

GET /ReSendInvoice


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
transactionid	Transaction Id	query	string

Uses default content-types: application/json

200 OK: Successful response

TransactionResponse
400 Bad Request: Error response

ErrorResponse

Refund a previously settled transaction (possible to refund only a part of the transaction by specifying an amount)

GET /ReturnTransaction


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
transactionId	TransactionId to refund	query	string
amount	Amount to refund (transaction will be refunded completely if not specified) Format: Number with 2 decimals places	query	number (double)

Uses default content-types: application/json

200 OK: Successful response

VoidedTransactionResponse
400 Bad Request: Error response

ErrorResponse

Refund a previously settled transaction (possible to refund only a part of the transaction by specifying an amount)

GET /ReturnTransactionByReferenceNumber


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
PNRef	The transaction PNRef	query	string
amount	Amount to refund (transaction will be refunded completely if not specified) Format: Number with 2 decimals places	query	number (double)

Uses default content-types: application/json

200 OK: Successful response

VoidedTransactionResponse
400 Bad Request: Error response

ErrorResponse

Updates card vault information

GET /UpdateCardInVault


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
transactionId	/AddToCardVault transaction Id	query	integer (int64)
name	Cardholder Name	query	string
streetaddress	Street Adress	query	string
city	City	query	string
state	State	query	string
zipcode	Zip Code	query	string
cardnumber	Card Number	query	string
expdate	Expiration Date (MMYY)	query	string
cvv	CVV Code	query	string
email	User Email	query	string

Uses default content-types: application/json

200 OK: Successful response

CreditTransactionResponse
400 Bad Request: Error response

ErrorResponse

Updates an already proceeded transaction basic information.

GET /UpdateTransaction


APIUn	API username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
gatewayCode	The gatewayCode used to initiate the transaction.	query	string
Invoice	The new invoice number. If sent the invoice number will be updated.	query	string
poNumber	The new PONumber. If sent the PONumber number will be updated.	query	string
customFields	JSON array of TransactionCustomField	query	string

Uses default content-types: application/json

200 OK: Successful response

CreditTransactionResponse
400 Bad Request: Error response

ErrorResponse

Validates if the entered credentials are valid for performing any action with the API.

GET /ValidateCredentials


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string

Uses default content-types: application/json

200 OK: Successful response

LoginResponse
400 Bad Request: Error response

ErrorResponse

Void a previously unsettled transaction (usually wihtin the same day)

GET /VoidTransaction


username	Username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
transactionId	TransactionId to void	query	string

Uses default content-types: application/json

200 OK: Successful response

VoidedTransactionResponse
400 Bad Request: Error response

ErrorResponse

Validate a credit card number.

GET /ValidateCard


APIUn	Your API username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
cardNumber	Card number to validate	query	string
cvv	Card cvv (Validated if provided.)	query	string
expDate	Card expiration card (Validated if provided.)	query	string

Uses default content-types: application/json

200 OK: Successful response

BaseResponse
400 Bad Request: Error response

ErrorResponse

GET /RegisterWebHooks


APIUn	Your API username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string
webhookURL	Webhook URI	query	string
webhookUsername	Username we will use to authenticate using Basic Authentication header. We will include an encoded string in the Authorization header of each POST request.	query	string
webHookPassword	Password we will use to authenticate using Basic Authentication header. We will include an encoded string in the Authorization header of each POST request.	query	string
recurringBillingOnly	When set to true, only recurring billings will trigger a call, all transactions will trigger a call otherwise. The default value is true .	query	string

Uses default content-types: application/json

Posted request

TransactionResponse

Expected Response

BaseResponse

Deactivate Webhooks

GET /DeactivateWebhooks


APIUn	Your API username	query	string
password	Password (for additional security)	query	string
apikey	API Key	query	string
devicecode	Device Code (if using multiple devices)	query	string

Uses default content-types: application/json

200 OK: Response

BaseResponse

Schema definitions

CreateRecurringResponse: object

Status: string
Message: string: Additional information
Data: CreateRecurringResponseData

CreateRecurringResponseData: object

RecurringId: integer (int64): Recurring id
Amount: decimal: Recurring amount
Frequency: string: Frequency returned in human readable format
BeginDate: string: Recurring billing starting on
EndDate: string: Recurring billing ending on
Active: boolean: Is active
NumberOfProcessedPayments: integer (int64): Number of processed payments
AccountNumber: string: Last 4 digits of the account number.
ExpDate: string: Expiration date for credit card transactions.
CardType: string: Credit card type. (VISA, MasterCard, AMEX, Other)
LastBillingDate: string: Last Billing Date
NextBillingDate: string: Next Billing Date

DeleteRecurringBillingResponse: object

Status: string
Message: string: Additional information
Data: DeleteRecurringBillingResponse

CreditTransactionResponse: object

Status: string
Code: Integer: TransactionResponse Code
Message: string: Additional information
Data: CreditTransactionResponseData
Customer: Customer

CreditTransactionResponseData: object

TransactionId: integer (int64): Transaction id
AuthNumber: string: Auth number returned by payment processor.
CardNumber: string: Last 4 digits of card number. Not returned when performing a swipped transaction.
CardholderName: string: Cardholder name. Not returned when performing a swipped transaction.
Amount: decimal: Amount billed.
CardType: string: Credit card type. (VISA, MasterCard, AMEX, Other)
ExpDate: string: Expiration date.
Invoice: string: Invoice number.
PONumber: string: Purchase Order number.
GatewayCode: string: Payment processor identifier.
NameOnCheck string: Name on Check
PaymentMode: PaymentModeEnum: Used Payment Mode
PreTransactionUniqueId string: Pre-Transaction unique identifier
Success Boolean
VoidedOnUtc TimeSpan
VoidTransactionId Integer: Voided Transaction Identifier
Refunds: List of VoidedTransactionResponse
FailedTransactionReason String: Reason of a declined transaction

TransactionResponse: object

Status: string
Code: Integer: TransactionResponse Code
Message: string: Additional information
Data: TransactionResponseData
Customer: Customer

TransactionResponseData: object

TransactionId: integer (int64): transaction id
AuthNumber: string: auth number returned by payment processor.
AccountNumber: string: Last 4 digits of the account number. Not returned when performing a swipped transaction.
CardholderName: string: Cardholder name. Not returned when performing a swipped transaction.
holderName: string: holder name.
Amount: decimal: Amount billed.
CardType: string: Credit card type. (VISA, MasterCard, AMEX, Other)
ExpDate: string: Expiration date.
Invoice: string: Invoice number.
PreTransactionUniqueId: string: The unique identifier of the preTransaction if applied.

Customer: object

Name: string: name
Address: string: address
City: string: city
State: string: state
ZipCode: string: zip code

ErrorResponse: object

Status: string: always 'error'
Message: string: Error description

GetPriceResponse: object

Status: string
Message: string: Additional information
Data: GetPriceResponseData

GetPriceResponseData: object

Price: number (double): price for the current device
ReceiptCode: string: receipt code for the current device

LoginResponse: object

Status: string
Message: string: Additional information
Data: LoginResponseData

LoginResponseData: object

Id: integer (int64): user id
Username: string: username
FirstName: string: First name
LastName: string: Last name
Permissions: integer[]: Array of available permissions id

integer (int64)

PreTransactionResponse: object

Status: string
Message: string: Additional information
Data: PreTransactionResponseData
Customer: Customer

BatchTransactionResponse: object

Status: string
Message: string
TotalTransactionCount: integer
TotalRefundCount: integer
TotalVoidCount: integer: Additional information
Data: List of TransactionResponseData

PreTransactionResponseData: object

PreTransactionId: integer (int64): pre transaction id
UniqueId: string: UniqueId to keep for future pre transaction operations.
IFrameSrc: string: The IFrame source to host the page.

SurchargeResponse: object

SurchargeAmount: Decimal: SurchargeAmount
SurchargeIdentifier: String: Surcharge identifier.

TransactionCustomField: object

CustomFieldName: string: The custom field name
Value: string: The custom field value

e.g.
{"CustomFieldName":"MyField1","Value":"MyFieldValue"}

TransactionProducts: object

Identifier: string: The product identifier, available on the product webpage.
Quantity: double: Quantity

VoidedTransactionResponse: object

Status: string
Message: string: Additional information
Data: VoidedTransactionResponseData
Customer: Customer

BaseResponse: object

Status: string (Possible values 'success' 'error')
Message: string

VoidedTransactionResponseData: object

TransactionId: integer (int64): Originial transaction id
VoidId: integer (int64): void transaction id
AuthNumber: string: PNRef returned by payment processor.
TransCode: string: auth code returned by payment processor.

PaymentModeEnum: Enum

Credit: 58: Only credit option will be available on checkout for PreTransaction.
ACH: 68: Only ACH option will be available on checkout for PreTransaction.
All: 78: The user will choose the payment mode on checkout for PreTransaction.

TransactionType: Enum

Capture: 1: The transaction will be captured.
Auth: 106: Authorization.

Recurring Billing Frequency: Enum

54 Every Day
38 Every Week
40 Every Two Weeks
42 Every Three Weeks
43 Every Four Weeks
44 Every Five Weeks
45 Every Six Weeks
49 Every Month
50 Every Two Months
91 Every Three Months
92 Every Six Months
93 Every Year

Code: integer

-100 Not processed: Transaction not processed; generic host error.
0 Success: Transaction was successful.
1 Failed: Authentication failed.
2 Rejected: Transaction was rejected by processor.
4 Invalid data: Invalid amount.
5 Invalid data: Invalid merchant information.
7 Invalid data: Invalid CVNumber.
12 Declined: Declined by the card issuer.
19 Invalid data: Original transaction ID not found.
20 Invalid data: Customer reference number not found.
22 Invalid data: Invalid ABA Number.
23 Invalid data: Invalid account number.
24 Invalid data: Invalid EXPDate.
28 Invalid data: Invalid check holder name.
50 Invalid amount: Insufficient funds available.
99 Unknown: Unknown Transaction Failure.
101 Timeout: Timeout value too small or invalid timeout value.
102 Processor error.: Processor not available.
103 Processor error.: Error reading response from host.
104 Processor error.: Timeout waiting for processor response.
108 Void error.: Void error.
110 Transaction error.: Duplicate transaction.
113 Invalid amount.: Cannot exceed sales cap.
501 DecryptionFailure: Unable to decrypt secure transaction due to invalid data or invalid decryption keys.
502 UnregisteredKSID: Secure device's ID is not registered as a SecureLink device.
507 NeedSecureLinkAccount: User is not authorized for SecureLink transactions.
508 NeedSecureLinkEULA: User has not yet signed the SecureLink license agreement.
702 Invalid Data: Invalid ExpDate.
1000 Host error: Generic host error.
1001 Invalid data: Invalid login.
1002 Invalid Data: Insufficient privilege or invalid amount.
1006 Invalid Data: Unsupported processor.
1006 Processor error: Error checking duplicate.