Section 3.1 - Service Location: link
For SOAP connections:
https://demo.spweblink.com/service/transact.asmx?op=Transact
For standard HTTPS connections:
https://demo.spweblink.com/service/transact.asmx
Description:
The web service is used whenever a transaction is completed via customer Credit Card, Debit Card, EBT Card, Gift or Loyalty Card.
Supported by this Method for TransType include:
-
AUTH
-
SALE
-
RETURN
-
VOID
-
POSTAUTH
-
FORCEAUTH
-
REPEATSALE
-
ADJUST
-
INQUIRY
-
ACTIVATE
-
DEACTIVATE
-
RELOAD
-
VOIDSALE
-
VOID_RETURN
-
VOID_AUTH
-
VOID_POSTAUTH
-
VOID_FORCEAUTH
-
REVERSAL
-
WITHDRAWAL
-
ISSUE
-
CASHOUT
-
REPLACE
-
MERGE
-
REPORTLOST
-
REDEEM
-
VERIFY
-
REACTIVATE
-
FORCED_ISSUE
-
FORCED_ADD
-
UNLOAD
-
TOKENIZE
-
INCREMENTAL_AUTH
-
BALANCE_LOCK
-
REDEMPTION_UNLOCK
Processors supporting the restaurant or ‘retail tip’ adjustment function only:
-
ADJUST
Section 3.1.1 - Developer Notes: link
-
Negative values not necessary when processing a Return or Void. Because we know these transactions are not reducing the cardholder’s funds, we handle the processors’ message in the background.
-
Invalid Characters: Some parameters and XML tags contain data that will automatically remove invalid characters from the user-entered data. These parameters and tags include:
-
InvNum
-
Zip
-
Street
-
ExtData: <CustCode>
-
Extdata: <RegisterNum>
-
ExtData: <City>
-
ExtData: <BillToState>
-
ExtData: <PONum>
-
Section 3.1.2 - Transact Input Parameters: link
O = Optional, R = Required, C = Conditional, R* = Required except on initial Request, R1 = Required on Force transactions.
Parameter Name |
Opt/Req/ Conditional |
Max Length |
Description |
---|---|---|---|
UserName |
R |
32 |
API user name assigned in the payment server. The user must have an appropriate level of access within the system in order to utilize the web service. |
Password |
R |
32 |
API Password associated with the user name. |
PosID |
R |
24 |
Value assigned by Nuvei to identify the ECR/POS Station. Assigned by Nuvei to identify the ECR/POS station |
Token |
R |
64 |
Value assigned by Nuvei to identify the ISV |
TraceNum |
R* |
14 |
Unique identifier of the transaction. Assigned by Nuvei’s Web Service at the initial time of transaction. Recommended to include on receipt. |
SerialNum |
R |
10 |
Unique Serial Number of the Payment device. |
TerminalID |
R |
24 |
Identifies individual payment terminal (lane) within a group. Assigned by Nuvei. |
TimeOut |
R |
2 |
Set in seconds. Maximum is 90 seconds. |
WorkstationID |
O |
24 |
Value assigned by ISV to the workstation |
R |
20 |
Identifies the type of credit card transaction being made. Valid values can be found with definitions in Appendix A. |
|
TenderType |
R |
8 |
Identifies the Tender Type being made. Valid values are: Credit – Credit Card Debit – Debit Card EBT – Electronic Benefits/Food Stamps/Cash Benefits Gift – Gift Card Loyalty – Loyalty Card |
Amount |
R |
8 |
Transaction total amount Format: $$$$$.CC |
OrigRefNum |
O |
4 |
Terminal reference number |
CashBackAmt |
O/C |
8 |
Applies to Debit processing only Casback amount format: $$$$$.CC |
FuelAmt |
O |
8 |
Used for Fleet Processing. Not supported at this time. |
ClerkID |
O |
8 |
Employee Clerk ID. Can also be used for “ServerID” in restaurant mode. |
ZIP |
O |
9 |
Cardholder Billing ZIP. Used for manually keyed transactions only. No hyphens allowed. |
TipAmt |
O |
8 |
The amount should be included in the total amount. For reporting and receipt purposes only. TipAmt format: $$$$$.CC See Adjust to perform a standard tip at a later time. |
TaxAmt |
O |
8 |
The amount should be included to the total amount. The amount should be included to the total amount. For reporting and receipt purposes only. TaxAmt format: $$$$$.CC |
Street1 |
O |
32 |
Cardholder Billing address |
Street2 |
O |
32 |
Cardholder Billing address line 2 |
SurchargeAmt |
O |
8 |
Convenience fee used for Debit TenderType, amount is added to the cost of a good or service. This function may be used by utility companies, government agencies, and schools. SurchargeAmt format: $$$$$.CC |
InvNum |
O |
16 |
Length varies by processor. |
ECRRefNum |
R |
16 |
The ECR Reference Number. This is a unique code on the ECR side. It will be returned in the Response message. |
ECRTransID |
O |
19 |
The ECR Transaction ID, must be unique for each transaction sent to host. Valid for *Heartland Portico only. It will be mapped to ClientTxnId field in the Heartland Portico API. |
AuthCode |
R1/C |
10 |
Will be required for a FORCEAUTH. The Merchant receives this when calling the processor’s Voice Authorization Center. |
SigSavePath |
O |
128 |
The file path taken to save the signature received from the terminal. When it is set, the file will be saved to a user-designated folder. If it is not set, it will be saved to the default folder, which is <install dir>\img\receipts\ |
Account |
O |
19 |
Cloud Connect Web Service does not support any sensitive Payment Account data. |
ExpDate |
O |
4 |
This is only relevant for payment processors who support Tokenization. It will be required when performing a HostToken transaction. |
CVV |
O |
4 |
Cloud Connect Web Service does not support any sensitivee Payment Account data. |
EBTFoodStampVoucher |
C |
Boolean T or F |
This is a switch to on/off the EBT Food stamp voucher mode, and this is valid when the TenderType is or “EBT.” Its default value is “F.” |
VoucherNum |
C |
16 |
Valid for TenderType of EBT |
Force |
O |
T |
Force processing of duplicate transactions. If this tag value is set to “T”, the host will not check for duplicates, also it will override the local duplicate check. “T” is the only valid value. Any value other than “T” will be ignored. |
FirstName |
C |
32 |
First name of card holder. |
LastName |
C |
32 |
Last name of card holder. |
CountryCode |
C |
2 |
Two-character ISO 3166 country codes for cardholder. Refer to ISO.org’s Country Code library for the latest standards. |
StateCode |
C |
2 |
Two Character US State and Canadian Province Codes. Refer to the United States Postal Service for the most recent list. |
CityName |
C |
32 |
City of cardholder. |
EmailAddress |
C |
64 |
Email address of cardholder. |
CheckSaleType |
Not supported at this time. |
||
CheckRoutingNum |
Not Supported at this time. |
||
CheckNum |
Not Supported at this time. |
||
CheckType |
Not Supported at this time. |
||
CheckIDType |
Not Supported at this time. |
||
CheckIDValue |
Not Supported at this time. |
||
Birth |
Not Supported at this time. |
||
PhoneNum |
Not Supported at this time. |
||
TimeStamp |
O |
14 |
The Date Time Value. YYYYMMDDhhmmss, if this field is NULL, terminal will use local time. Used for Trace information. |
ShiftID |
O |
8 |
Shift ID information for the cashier. |
CustomerCode |
C |
32 |
Used for Level 2 processing with Corporate and Purchase cards. Assigned by POS. |
PONum |
O |
32 |
Used for Level 2 processing with Corporate or Purchase cards. Purchase Order number or any reference number used to identify a transaction. |
TaxExempt |
C |
Boolean 0 or 1 |
Used for Level 2 processing with Corporate or Purchase cards. Tax Exempt Indicator Values: “0” = Tax Not Exempt “1” = Tax Exempt |
TaxExemptID |
C |
12 |
Used for Level 2 processing with Corporate or Purchase cards. The Tax-Exempt ID. |
MerchantTaxID |
C |
15 |
Used for Level 2 processing with Corporate or Purchase cards. The Merchant TaxID. |
DestinationZipCode |
C |
9 |
Used for Level 2 processing with Corporate or Purchase cards. The destination ZIP Code. |
ProductDescription |
C |
40 |
Used for Level 2 processing with Corporate or Purchase cards. Product Description |
MOTOEcommerceMode |
Currently not supported. |
||
MOTOEcommerceTransType |
Currently not supported. |
||
ECommerceSecureType |
Currently not supported. |
||
MOTOECommerceOrderNum |
Currently not supported. |
||
Installments |
Currently not supported. |
||
CurrentInstallment |
Currently not supported. |
||
TableNum |
C |
4 |
Applicable to Restaurant processing. Table number assigned by POS. |
GuestNum |
C |
4 |
Applicable to Restaurant processing. Table number assigned by POS. |
SignatureCapture |
C |
1 |
The ECR supports signature printing and the terminal supports signature capture. If this field exists, the values below are valid: ‘0’- Do Not Capture, ‘1’- Capture. Default value = “0”. |
TicketNum |
C |
8 |
Applicable to Restaurant transaction processing. Ticket number assigned by POS. |
HRefNum |
C |
32 |
Host Reference Number or (Transaction UID). This field is host dependent; it can be used to run Void/Return transactions. If this field is returned, it should be printed on the receipt. |
TipRequest |
C |
Boolean 0 or 1 |
Valid Values: “0” = Tip Entry Not Required “1” = Tip Entry Required |
SignUploadFlag |
C |
Boolean 0 or 1 |
Valid Values: “0” = Signature Upload Not Required “1” = Signature Upload Required If this tag is not sent to the POS, the terminal will upload the signature by default only when signature upload is supported by the host. |
ReportStatus |
O |
Boolean 0 or 1 |
Whether to report status back. 1: Report. 0: Do not report |
TokenRequest |
C |
Boolean 0 or 1 |
Retrieves HostToken Value from the processor for a HostToken that has already been generated. To perform this function, use TransType of CREDIT, TenderType of Sale and populate TokenRequest with 0. When populating TokenRequest with a value of 1, the payment device will prompt you for the AVS and CVV of the payment card. Dependent upon processor. |
CardType |
C |
4 |
Required for Multi-Pay Token transactions depending upon the processor. |
CardTypeBitmap |
C |
4 |
In order to accept CardType Multi-Pay Tokens, this allows a POS system to control which card types accepted for current command. Processor dependent. |
PassthruData |
O |
256 |
No longer supported. |
ReturnReason |
O |
Boolean 0 or 1 |
Reason for a RETURN command: “0” = General Return “1” = Adjustment If the host requires this mandatory field, the default value of “0” will be sent. |
OrigTransDate |
C |
8 |
Original Transaction Date in YYYYMMDD format. Conditional for some hosts for subsequent transactions after SALE, i.e. RETURN. If the host requires this mandatory field, the current date on terminal will be sent. |
OrigPAN |
Not supported. |
||
OrigExpiryDate |
Not supported. |
||
OrigTransTime |
C |
6 |
Original Transaction Time in HHMMSS format. Conditional for some hosts for subsequent transactions after SALE, i.e. RETURN. If the host requires this mandatory field, the current time on terminal will be sent. |
DisProgPrompt |
O |
8 |
The default prompt is always on and depending on the bin file. It can be turned off by submitting a “1” in its defined program location. |
GatewayID |
C |
64 |
This is used to provide a unique value to identify a Gateway or Aggregator. Only valid for TSYS at the moment. |
POSEchoData |
O |
2048 |
This is user-defined data by the POS developer, the value can be up to 2048 bytes. If the field has been set, the payment terminal will not store and/or parse the contents of this field. The device will just follow the normal logic based off the host’s specifications or the POS developer’s requirement(s) to include in the request message. |
GetSign |
O |
Boolean 0 or 1 |
Whether to get the signature data: “0” = Not to Upload “1” = Capture The default is 0 |
EntryModeBitmap |
O |
8 |
Allows POS to control the various entry modes programmatically. |
ReceiptPrint |
O |
1 |
Receipt printing for current command, default as “0 = No Receipt”, it will override the ReceiptPrint settings in the terminal. “0” = No Receipt “1” = Merchant Only “2” = Customer Only “3” = Both Merchant/Customer Copy |
CPMode |
O |
1 |
Card Present Mode for current command: “0” = Default Value, use terminal’s card present setting. “1” = Don’t prompt, assume card is present. “2” = Don’t prompt, assume card is not present. |
Odometer |
Used for processing Fleet. Currently not supported. |
||
VehicleNo |
O |
Used for processing Fleet. Currently not supported. |
|
JobNo |
O |
Used for processing Fleet. Currently not supported. |
|
DriverID |
O |
Used for processing Fleet. Currently not supported. |
|
EmployeeNo |
O |
Used for processing Fleet. Currently not supported. |
|
LicenceID |
O |
Used for processing Fleet. Currently not supported. |
|
DepartmentNo |
O |
Used for processing Fleet. Currently not supported. |
|
UserID |
O |
Used for processing Fleet. Currently not supported. |
|
VehicleID |
O |
Used for processing Fleet. Currently not supported. |
|
HostToken |
O/C |
16 |
Used for with Processors who suport Tokenization. This field will be used to pass the Token generated by the payment Processor. |
ExtData |
O |
Used for processing Fleet. Currently not supported. |
Transact Response Data Definitions O = Optional, R = Required, C = Conditional
Parameter Name |
Opt/Req/ Conditional |
Max Length |
Description |
---|---|---|---|
ResultCode |
R |
6 |
Transaction Result Code |
ResultTxt |
C |
*Only returned on JSON message format |
|
ResultMsg |
R |
32 |
Transaction Result Text |
TransType |
R |
20 |
Identifies the type of credit card transaction being made. Valid values can be found with definitions in Appendix A. |
PosID |
R |
24 |
Value assigned by Nuvei to identify the ECR/POS Station. Assigned by Nuvei to identify the ECR/POS station |
IPaddress |
R |
128 |
IP address of initiating transaction |
Port |
R |
9 |
Port of the initiating transaction |
MacAddress |
R |
48 |
Identifies MAC address of payment device |
TerminalID |
R |
24 |
Identifies individual payment terminal (lane) within a group. Assigned by Nuvei. |
Token |
R |
64 |
Value assigned by Nuvei to identify the ISV |
SerialNum |
R |
10 |
Unique Serial number of payment device. |
Amount |
R |
Amount requested for approval in original transaction request. Could be different than amount approved. Format: $$$$$.CC |
|
TraceNum |
R |
14 |
Unique identifier of the transaction. Assigned by Nuvei web service at the initial time of transaction. Recommended to include on receipt. |
AuthCode |
R |
8 |
Authorization code returned from payment processor |
ApprovedAmount |
R |
8 |
Amount approved by payment processor Format: $$$$$.CC |
MaskedPan |
R |
4 |
Displays last 4 digits of Payment Card Number |
RemainingBalance |
C |
8 |
The cardholder’s balance amount. If TenderType is EBT, this equates to the Cash Benefits balance. If TenderType is Credit (prepaid branded Gift), this equates to the Issuer returned balance. Varies by Card Issuer. Format: $$$$$.CC |
ExtraBalance |
C |
8 |
The cardholder’s balance amount. If TenderType is EBT, this equates to the Food Stamp balance. Format: $$$$$.CC |
CardType |
O/C |
16 |
Displays Card Type. Varies by Payment Processor. See Appendix B for values. |
Parameter Name |
Opt/Req/ Conditional |
Max Length |
Description |
---|---|---|---|
AvsResponse |
O/C |
8 |
AVS response value returned by Payment Processor |
CvResponse |
O/C |
8 |
CVV response value returned by Payment Processor |
HostCode |
R |
32 |
Host reference number. |
HostResponse |
O/C |
8 |
Host Response or Error Code. Varies based on Payment Processor. |
HostMessage |
O/C |
32 |
Host or Gateway message. Varies based on Payment Processor or Gateway. |
RefNum |
O/C |
4 |
Reference Number/Transaction Number 0 < Index <= 5000, normal use data 5001 < Index <=9000, stored database for SAF 9001 < Index <=9999, failed database for SAF |
ECRRefNum |
O |
16 |
The ECR Reference Number. This is a unique code on the ECR side. |
TransDate |
R |
8 |
Transaction Date in YYYYMMDD format. |
TransTime |
R |
6 |
Transaction Time in HHMMSS format. |
OrigRefNum |
O |
4 |
Terminal reference number, used for follow-on ADJUST, VOID, POSTAUTH, CAPTURE, REPEATSALE, TransTypes. Assigned by Nuvei. |
BatchNum |
O |
32 |
Host Batch Number. Response varies by Processor. |
RawResponse |
O/C |
VAR |
Gateway Response – if applicable |
ExtData |
C |
VAR |
Data included in ExtData varies based on processor feature support, TenderType and other response data. See Appendix C for EMV response data. |
Section 3.2 - Transact XML Schema link
Section 3.2.1 - SOAP 1.1 Request and Response link
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
POST /Service/PosService.asmx HTTP/1.1
Host: demo.spweblink.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "https://secure.spweblink.com/Transact"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<Transact xmlns="https://secure.spweblink.com/">
<UserName>string</UserName>
<Password>string</Password>
<WorkstationID>string</WorkstationID>
<PosID>string</PosID>
<Token>string</Token>
<TerminalID>string</TerminalID>
<SerialNum>string</SerialNum>
<TraceNum>string</TraceNum>
<TimeOut>string</TimeOut>
<TenderType>string</TenderType>
<TransType>string</TransType>
<Amount>string</Amount>
<CashBackAmt>string</CashBackAmt>
<FuelAmt>string</FuelAmt>
<ClerkID>string</ClerkID>
<Zip>string</Zip>
<TipAmt>string</TipAmt>
<TaxAmt>string</TaxAmt>
<Street>string</Street>
<Street2>string</Street2>
<SurchargeAmt>string</SurchargeAmt>
<PONum>string</PONum>
<OrigRefNum>string</OrigRefNum>
<InvNum>string</InvNum>
<ECRRefNum>string</ECRRefNum>
<ECRTransID>string</ECRTransID>
<AuthCode>string</AuthCode>
<SigSavePath>string</SigSavePath>
<Account>string</Account>
<ExpDate>string</ExpDate>
<CVV>string</CVV>
<EBTFoodStampVoucher>string</EBTFoodStampVoucher>
<VoucherNum>string</VoucherNum>
<Force>string</Force>
<FirstName>string</FirstName>
<LastName>string</LastName>
<CountryCode>string</CountryCode>
<StateCode>string</StateCode>
<CityName>string</CityName>
<EmailAddress>string</EmailAddress>
<CheckSaleType>string</CheckSaleType>
<CheckRoutingNum>string</CheckRoutingNum>
<CheckNum>string</CheckNum>
<CheckType>string</CheckType>
<CheckIDType>string</CheckIDType>
<CheckIDValue>string</CheckIDValue>
<Birth>string</Birth>
<PhoneNum>string</PhoneNum>
<TimeStamp>string</TimeStamp>
<ShiftID>string</ShiftID>
<CustomerCode>string</CustomerCode>
<TaxExempt>string</TaxExempt>
<TaxExemptID>string</TaxExemptID>
<MerchantTaxID>string</MerchantTaxID>
<DestinationZipCode>string</DestinationZipCode>
<ProductDescription>string</ProductDescription>
<MOTOECommerceMode>string</MOTOECommerceMode>
<MOTOECommerceTransType>string</MOTOECommerceTransType>
<ECommerceSecureType>string</ECommerceSecureType>
<MOTOECommerceOrderNum>string</MOTOECommerceOrderNum>
<Installments>string</Installments>
<CurrentInstallment>string</CurrentInstallment>
<TableNum>string</TableNum>
<GuestNum>string</GuestNum>
<SignatureCapture>string</SignatureCapture>
<TicketNum>string</TicketNum>
<HRefNum>string</HRefNum>
<TipRequest>string</TipRequest>
<SignUploadFlag>string</SignUploadFlag>
<ReportStatus>string</ReportStatus>
<TokenRequest>string</TokenRequest>
<CardType>string</CardType>
<CardTypeBitmap>string</CardTypeBitmap>
<PassthruData>string</PassthruData>
<ReturnReason>string</ReturnReason>
<OrigTransDate>string</OrigTransDate>
<OrigPAN>string</OrigPAN>
<OrigExpiryDate>string</OrigExpiryDate>
<OrigTransTime>string</OrigTransTime>
<DisProgPrompt>string</DisProgPrompt>
<GatewayID>string</GatewayID>
<POSEchoData>string</POSEchoData>
<GetSign>string</GetSign>
<EntryModeBitmap>string</EntryModeBitmap>
<ReceiptPrint>string</ReceiptPrint>
<CPMode>string</CPMode>
<Odometer>string</Odometer>
<VehicleNo>string</VehicleNo>
<JobNo>string</JobNo>
<DriverID>string</DriverID>
<EmployeeNo>string</EmployeeNo>
<LicenseNo>string</LicenseNo>
<JobID>string</JobID>
<DepartmentNo>string</DepartmentNo>
<CustomerData>string</CustomerData>
<UserID>string</UserID>
<VehicleID>string</VehicleID>
<HostToken>string</HostToken>
<ExtData>string</ExtData>
</Transact>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<TransactResponse xmlns="https://secure.spweblink.com/">
<TransactResult>
<ResultCode>string</ResultCode>
<ResultTxt>string</ResultTxt>
<ResultMsg>string</ResultMsg>
<TransType>string</TransType>
<IPaddress>string</IPaddress>
<PosID>string</PosID>
<Port>string</Port>
<MacAddress>string</MacAddress>
<TerminalID>string</TerminalID>
<Token>string</Token>
<SerialNum>string</SerialNum>
<Amount>string</Amount>
<TraceNum>string</TraceNum>
<AuthCode>string</AuthCode>
<ApprovedAmount>string</ApprovedAmount>
<MaskedPAN>string</MaskedPAN>
<RemainingBalance>string</RemainingBalance>
<ExtraBalance>string</ExtraBalance>
<CardType>string</CardType>
<AvsResponse>string</AvsResponse>
<CvResponse>string</CvResponse>
<HostCode>string</HostCode>
<HostResponse>string</HostResponse>
<HostMessage>string</HostMessage>
<RefNum>string</RefNum>
<ECRRefNum>string</ECRRefNum>
<TransDate>string</TransDate>
<TransTime>string</TransTime>
<OrigRefNum>string</OrigRefNum>
<BatchNum>string</BatchNum>
<SigFileName>string</SigFileName>
<SignData>string</SignData>
<RawResponse>string</RawResponse>
<ExtData>string</ExtData>
</TransactResult>
</TransactResponse>
</soap:Body>
</soap:Envelope>
Section 3.2.2 - SOAP 1.2 Request and Response link
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
POST /Service/PosService.asmx HTTP/1.1
Host: demo.spweblink.com
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<Transact xmlns="https://secure.spweblink.com/">
<UserName>string</UserName>
<Password>string</Password>
<WorkstationID>string</WorkstationID>
<PosID>string</PosID>
<Token>string</Token>
<TerminalID>string</TerminalID>
<SerialNum>string</SerialNum>
<TraceNum>string</TraceNum>
<TimeOut>string</TimeOut>
<TenderType>string</TenderType>
<TransType>string</TransType>
<Amount>string</Amount>
<CashBackAmt>string</CashBackAmt>
<FuelAmt>string</FuelAmt>
<ClerkID>string</ClerkID>
<Zip>string</Zip>
<TipAmt>string</TipAmt>
<TaxAmt>string</TaxAmt>
<Street>string</Street>
<Street2>string</Street2>
<SurchargeAmt>string</SurchargeAmt>
<PONum>string</PONum>
<OrigRefNum>string</OrigRefNum>
<InvNum>string</InvNum>
<ECRRefNum>string</ECRRefNum>
<ECRTransID>string</ECRTransID>
<AuthCode>string</AuthCode>
<SigSavePath>string</SigSavePath>
<Account>string</Account>
<ExpDate>string</ExpDate>
<CVV>string</CVV>
<EBTFoodStampVoucher>string</EBTFoodStampVoucher>
<VoucherNum>string</VoucherNum>
<Force>string</Force>
<FirstName>string</FirstName>
<LastName>string</LastName>
<CountryCode>string</CountryCode>
<StateCode>string</StateCode>
<CityName>string</CityName>
<EmailAddress>string</EmailAddress>
<CheckSaleType>string</CheckSaleType>
<CheckRoutingNum>string</CheckRoutingNum>
<CheckNum>string</CheckNum>
<CheckType>string</CheckType>
<CheckIDType>string</CheckIDType>
<CheckIDValue>string</CheckIDValue>
<Birth>string</Birth>
<PhoneNum>string</PhoneNum>
<TimeStamp>string</TimeStamp>
<ShiftID>string</ShiftID>
<CustomerCode>string</CustomerCode>
<TaxExempt>string</TaxExempt>
<TaxExemptID>string</TaxExemptID>
<MerchantTaxID>string</MerchantTaxID>
<DestinationZipCode>string</DestinationZipCode>
<ProductDescription>string</ProductDescription>
<MOTOECommerceMode>string</MOTOECommerceMode>
<MOTOECommerceTransType>string</MOTOECommerceTransType>
<ECommerceSecureType>string</ECommerceSecureType>
<MOTOECommerceOrderNum>string</MOTOECommerceOrderNum>
<Installments>string</Installments>
<CurrentInstallment>string</CurrentInstallment>
<TableNum>string</TableNum>
<GuestNum>string</GuestNum>
<SignatureCapture>string</SignatureCapture>
<TicketNum>string</TicketNum>
<HRefNum>string</HRefNum>
<TipRequest>string</TipRequest>
<SignUploadFlag>string</SignUploadFlag>
<ReportStatus>string</ReportStatus>
<TokenRequest>string</TokenRequest>
<CardType>string</CardType>
<CardTypeBitmap>string</CardTypeBitmap>
<PassthruData>string</PassthruData>
<ReturnReason>string</ReturnReason>
<OrigTransDate>string</OrigTransDate>
<OrigPAN>string</OrigPAN>
<OrigExpiryDate>string</OrigExpiryDate>
<OrigTransTime>string</OrigTransTime>
<DisProgPrompt>string</DisProgPrompt>
<GatewayID>string</GatewayID>
<POSEchoData>string</POSEchoData>
<GetSign>string</GetSign>
<EntryModeBitmap>string</EntryModeBitmap>
<ReceiptPrint>string</ReceiptPrint>
<CPMode>string</CPMode>
<Odometer>string</Odometer>
<VehicleNo>string</VehicleNo>
<JobNo>string</JobNo>
<DriverID>string</DriverID>
<EmployeeNo>string</EmployeeNo>
<LicenseNo>string</LicenseNo>
<JobID>string</JobID>
<DepartmentNo>string</DepartmentNo>
<CustomerData>string</CustomerData>
<UserID>string</UserID>
<VehicleID>string</VehicleID>
<HostToken>string</HostToken>
<ExtData>string</ExtData>
</Transact>
</soap12:Body>
</soap12:Envelope>
HTTP/1.1 200 OK
Content-Type: application/soap+xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
<soap12:Body>
<TransactResponse xmlns="https://secure.spweblink.com/">
<TransactResult>
<ResultCode>string</ResultCode>
<ResultTxt>string</ResultTxt>
<ResultMsg>string</ResultMsg>
<TransType>string</TransType>
<IPaddress>string</IPaddress>
<PosID>string</PosID>
<Port>string</Port>
<MacAddress>string</MacAddress>
<TerminalID>string</TerminalID>
<Token>string</Token>
<SerialNum>string</SerialNum>
<Amount>string</Amount>
<TraceNum>string</TraceNum>
<AuthCode>string</AuthCode>
<ApprovedAmount>string</ApprovedAmount>
<MaskedPAN>string</MaskedPAN>
<RemainingBalance>string</RemainingBalance>
<ExtraBalance>string</ExtraBalance>
<CardType>string</CardType>
<AvsResponse>string</AvsResponse>
<CvResponse>string</CvResponse>
<HostCode>string</HostCode>
<HostResponse>string</HostResponse>
<HostMessage>string</HostMessage>
<RefNum>string</RefNum>
<ECRRefNum>string</ECRRefNum>
<TransDate>string</TransDate>
<TransTime>string</TransTime>
<OrigRefNum>string</OrigRefNum>
<BatchNum>string</BatchNum>
<SigFileName>string</SigFileName>
<SignData>string</SignData>
<RawResponse>string</RawResponse>
<ExtData>string</ExtData>
</TransactResult>
</TransactResponse>
</soap12:Body>
</soap12:Envelope>
Section 3.2.3 - HTTPS GET Request and Response link
The following is a sample HTTPS GET request and response. The placeholders shown need to be replaced with actual values.
GET /Service/PosService.asmx/Transact?UserName=string&Password=string&WorkstationID=string&PosID=string&Token=string&TerminalID=string&SerialNum=string&TraceNum=string&TimeOut=string&TenderType=string&TransType=string&Amount=string&CashBackAmt=string&FuelAmt=string&ClerkID=string&Zip=string&TipAmt=string&TaxAmt=string&Street=string&Street2=string&SurchargeAmt=string&PONum=string&OrigRefNum=string&InvNum=string&ECRRefNum=string&ECRTransID=string&AuthCode=string&SigSavePath=string&Account=string&ExpDate=string&CVV=string&EBTFoodStampVoucher=string&VoucherNum=string&Force=string&FirstName=string&LastName=string&CountryCode=string&StateCode=string&CityName=string&EmailAddress=string&CheckSaleType=string&CheckRoutingNum=string&CheckNum=string&CheckType=string&CheckIDType=string&CheckIDValue=string&Birth=string&PhoneNum=string&TimeStamp=string&ShiftID=string&CustomerCode=string&TaxExempt=string&TaxExemptID=string&MerchantTaxID=string&DestinationZipCode=string&ProductDescription=string&MOTOECommerceMode=string&MOTOECommerceTransType=string&ECommerceSecureType=string&MOTOECommerceOrderNum=string&Installments=string&CurrentInstallment=string&TableNum=string&GuestNum=string&=string&TicketNum=string&HRefNum=string&TipRequest=string&SignUploadFlag=string&ReportStatus=string&TokenRequest=string&CardType=string&CardTypeBitmap=string&PassthruData=string&ReturnReason=string&OrigTransDate=string&OrigPAN=string&OrigExpiryDate=string&OrigTransTime=string&DisProgPrompt=string&GatewayID=string&POSEchoData=string&GetSign=string&EntryModeBitmap=string&ReceiptPrint=string&CPMode=string&Odometer=string&VehicleNo=string&JobNo=string&DriverID=string&EmployeeNo=string&LicenseNo=string&JobID=string&DepartmentNo=string&CustomerData=string&UserID=string&VehicleID=string&HostToken=string&ExtData=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<PosPaymentResult xmlns="https://secure.spweblink.com/">
<ResultCode>string</ResultCode>
<ResultTxt>string</ResultTxt>
<ResultMsg>string</ResultMsg>
<TransType>string</TransType>
<IPaddress>string</IPaddress>
<PosID>string</PosID>
<Port>string</Port>
<MacAddress>string</MacAddress>
<TerminalID>string</TerminalID>
<Token>string</Token>
<SerialNum>string</SerialNum>
<Amount>string</Amount>
<TraceNum>string</TraceNum>
<AuthCode>string</AuthCode>
<ApprovedAmount>string</ApprovedAmount>
<MaskedPAN>string</MaskedPAN>
<RemainingBalance>string</RemainingBalance>
<ExtraBalance>string</ExtraBalance>
<CardType>string</CardType>
<AvsResponse>string</AvsResponse>
<CvResponse>string</CvResponse>
<HostCode>string</HostCode>
<HostResponse>string</HostResponse>
<HostMessage>string</HostMessage>
<RefNum>string</RefNum>
<ECRRefNum>string</ECRRefNum>
<TransDate>string</TransDate>
<TransTime>string</TransTime>
<OrigRefNum>string</OrigRefNum>
<BatchNum>string</BatchNum>
<SigFileName>string</SigFileName>
<SignData>string</SignData>
<RawResponse>string</RawResponse>
<ExtData>string</ExtData>
</PosPaymentResult>
Section 3.2.4 - HTTPS POST Request and Response link
The following is a sample HTTPS POST request and response. The placeholders shown need to be replaced with actual values.
POST /Service/PosService.asmx/Transact HTTP/1.1
Host: demo.spweblink.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserName=string&Password=string&WorkstationID=string&PosID=string&Token=string&TerminalID=string&SerialNum=string&TraceNum=string&TimeOut=string&TenderType=string&TransType=string&Amount=string&CashBackAmt=string&FuelAmt=string&ClerkID=string&Zip=string&TipAmt=string&TaxAmt=string&Street=string&Street2=string&SurchargeAmt=string&PONum=string&OrigRefNum=string&InvNum=string&ECRRefNum=string&ECRTransID=string&AuthCode=string&SigSavePath=string&Account=string&ExpDate=string&CVV=string&EBTFoodStampVoucher=string&VoucherNum=string&Force=string&FirstName=string&LastName=string&CountryCode=string&StateCode=string&CityName=string&EmailAddress=string&CheckSaleType=string&CheckRoutingNum=string&CheckNum=string&CheckType=string&CheckIDType=string&CheckIDValue=string&Birth=string&PhoneNum=string&TimeStamp=string&ShiftID=string&CustomerCode=string&TaxExempt=string&TaxExemptID=string&MerchantTaxID=string&DestinationZipCode=string&ProductDescription=string&MOTOECommerceMode=string&MOTOECommerceTransType=string&ECommerceSecureType=string&MOTOECommerceOrderNum=string&Installments=string&CurrentInstallment=string&TableNum=string&GuestNum=string&SignatureCapture=string&TicketNum=string&HRefNum=string&TipRequest=string&SignUploadFlag=string&ReportStatus=string&TokenRequest=string&CardType=string&CardTypeBitmap=string&PassthruData=string&ReturnReason=string&OrigTransDate=string&OrigPAN=string&OrigExpiryDate=string&OrigTransTime=string&DisProgPrompt=string&GatewayID=string&POSEchoData=string&GetSign=string&EntryModeBitmap=string&ReceiptPrint=string&CPMode=string&Odometer=string&VehicleNo=string&JobNo=string&DriverID=string&EmployeeNo=string&LicenseNo=string&JobID=string&DepartmentNo=string&CustomerData=string&UserID=string&VehicleID=string&HostToken=string&ExtData=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<PosPaymentResult xmlns="https://secure.spweblink.com/">
<ResultCode>string</ResultCode>
<ResultTxt>string</ResultTxt>
<ResultMsg>string</ResultMsg>
<TransType>string</TransType>
<IPaddress>string</IPaddress>
<PosID>string</PosID>
<Port>string</Port>
<MacAddress>string</MacAddress>
<TerminalID>string</TerminalID>
<Token>string</Token>
<SerialNum>string</SerialNum>
<Amount>string</Amount>
<TraceNum>string</TraceNum>
<AuthCode>string</AuthCode>
<ApprovedAmount>string</ApprovedAmount>
<MaskedPAN>string</MaskedPAN>
<RemainingBalance>string</RemainingBalance>
<ExtraBalance>string</ExtraBalance>
<CardType>string</CardType>
<AvsResponse>string</AvsResponse>
<CvResponse>string</CvResponse>
<HostCode>string</HostCode>
<HostResponse>string</HostResponse>
<HostMessage>string</HostMessage>
<RefNum>string</RefNum>
<ECRRefNum>string</ECRRefNum>
<TransDate>string</TransDate>
<TransTime>string</TransTime>
<OrigRefNum>string</OrigRefNum>
<BatchNum>string</BatchNum>
<SigFileName>string</SigFileName>
<SignData>string</SignData>
<RawResponse>string</RawResponse>
<ExtData>string</ExtData>
</PosPaymentResult>
Section 3.2.5 - JSON Format link
POST /Service/PosService.asmx/Transact HTTP/1.1
Host: demo.spweblink.com
Content-Type: application/json; charset=utf-8
Content-Length: length
{
"Transact": {
"UserName": "string",
"Password": "string",
"WorkstationID": "string",
"PosID": "string",
"Token": "string",
"TerminalID": "string",
"SerialNum": "string",
"TraceNum": "string",
"TimeOut": "string",
"TenderType": "string",
"TransType": "string",
"Amount": "string",
"CashBackAmt": "string",
"FuelAmt": "string",
"ClerkID": "string",
"Zip": "string",
"TipAmt": "string",
"TaxAmt": "string",
"Street": "string",
"Street2": "string",
"SurchargeAmt": "string",
"PONum": "string",
"OrigRefNum": "string",
"InvNum": "string",
"ECRRefNum": "string",
"ECRTransID": "string",
"AuthCode": "string",
"SigSavePath": "string",
"Account": "string",
"ExpDate": "string",
"CVV": "string",
"EBTFoodStampVoucher": "string",
"VoucherNum": "string",
"Force": "string",
"FirstName": "string",
"LastName": "string",
"CountryCode": "string",
"StateCode": "string",
"CityName": "string",
"EmailAddress": "string",
"CheckSaleType": "string",
"CheckRoutingNum": "string",
"CheckNum": "string",
"CheckType": "string",
"CheckIDType": "string",
"CheckIDValue": "string",
"Birth": "string",
"PhoneNum": "string",
"TimeStamp": "string",
"ShiftID": "string",
"CustomerCode": "string",
"TaxExempt": "string",
"TaxExemptID": "string",
"MerchantTaxID": "string",
"DestinationZipCode": "string",
"ProductDescription": "string",
"MOTOECommerceMode": "string",
"MOTOECommerceTransType": "string",
"ECommerceSecureType": "string",
"MOTOECommerceOrderNum": "string",
"Installments": "string",
"CurrentInstallment": "string",
"TableNum": "string",
"GuestNum": "string",
"SignatureCapture": "string",
"TicketNum": "string",
"HRefNum": "string",
"TipRequest": "string",
"SignUploadFlag": "string",
"ReportStatus": "string",
"TokenRequest": "string",
"CardType": "string",
"CardTypeBitmap": "string",
"PassthruData": "string",
"ReturnReason": "string",
"OrigTransDate": "string",
"OrigPAN": "string",
"OrigExpiryDate": "string",
"OrigTransTime": "string",
"DisProgPrompt": "string",
"GatewayID": "string",
"POSEchoData": "string",
"GetSign": "string",
"EntryModeBitmap": "string",
"ReceiptPrint": "string",
"CPMode": "string",
"Odometer": "string",
"VehicleNo": "string",
"JobNo": "string",
"DriverID": "string",
"EmployeeNo": "string",
"LicenseNo": "string",
"JobID": "string",
"DepartmentNo": "string",
"CustomerData": "string",
"UserID": "string",
"VehicleID": "string",
"HostToken": "string",
"ExtData": "string",
"_xmlns": "https://secure.spweblink.com/"
}
}
{
" PosPaymentResult": {
" PosPaymentResult": {
"ResultCode": "string",
"ResultTxt": "string",
"ResultMsg": "string",
"TransType": "string",
"IPaddress": "string",
"PosID": "string",
"Port": "string",
"MacAddress": "string",
"TerminalID": "string",
"Token": "string",
"SerialNum": "string",
"Amount": "string",
"TraceNum": "string",
"AuthCode": "string",
"ApprovedAmount": "string",
"MaskedPAN": "string",
"RemainingBalance": "string",
"ExtraBalance": "string",
"CardType": "string",
"AvsResponse": "string",
"CvResponse": "string",
"HostCode": "string",
"HostResponse": "string",
"HostMessage": "string",
"RefNum": "string",
"ECRRefNum": "string",
"TransDate": "string",
"TransTime": "string",
"OrigRefNum": "string",
"BatchNum": "string",
"SigFileName": "string",
"SignData": "string",
"RawResponse": "string",
"ExtData": "string"
},
"_xmlns": "https://secure.spweblink.com/"
}
}