Fiserv Parameter Push
This API is only for Fiserv Varsheet.
Overview
This endpoint is used to upload and push Fiserv WizarPOS payment configuration parameters to a specific terminal.
Environments
Sandbox
HTTPS
POST
https://uat.paywizard.biz/ovstrade/openVarSheet/fiserv/configuration/push
Production
HTTPS
POST
https://portal.paywizard.biz/ovstrade/openVarSheet/fiserv/configuration/push
Authentication
Authentication is handled through a JSON Web Token (JWT) included in the request header. A signature must also be provided in the headers for request verification.
For detailed instructions on generating the required signature, please refer to our Signature Generation Guide.
Endpoint: Push Fiserv Configuration
POST /ovstrade/openVarSheet/fiserv/configuration/push
Headers
Content-Type
String
Yes
Must be application/json.
jwt-token
String
Yes
The transaction token obtained using your developer credentials.
Request Body Parameters
clientId
String
Yes
Your unique developer ID.
pushData
Object
Yes
An object containing the configuration parameters to be pushed. See PushData Object below.
PushData Object
terminalSn
String
Yes
The serial number of the target terminal.
fiservCommunicationInfo
Object
No
Communication settings for connecting to Fiserv. See FiservCommunicationInfo Object.
fiservTerminalConfig
Object
No
Terminal-specific behavior and settings. See FiservTerminalConfig Object.
FiservMerchantInfo Object
merchantId
String
No
The merchant ID provided by Fiserv.
terminalId
String
No
The terminal ID provided by Fiserv.
tppId
String
No
The Third-Party Processor ID.
groupId
String
No
The group ID.
merchantName
String
No
The name of the merchant.
merchantAddress
String
No
The merchant's street address.
merchantCity
String
No
The merchant's city.
merchantState
String
No
The merchant's state or province.
merchantZip
String
No
The merchant's postal code.
merchantPhone
String
No
The merchant's phone number.
merchantEmail
String
No
The merchant's email address.
countryCode
String
No
The country code (e.g., "840" for USA).
currencyCode
String
No
The currency code (e.g., "840" for USD).
FiservCommunicationInfo Object
primaryHostName
String
No
The primary host URL for transactions.
srsDiscoverHostName
String
No
The host URL for SRS Discover.
srsHostName
String
No
The host URL for SRS.
communicationTimeout
String
No
The communication timeout in seconds.
FiservTerminalConfig Object
This object contains detailed settings for the terminal's payment application.
adminPass
String
No
The administrator password.
superPass
String
No
The supervisor password.
refundPass
String
No
The password required for processing refunds.
reversalPass
String
No
The password required for processing reversals.
tmkIndex
String
No
The Terminal Master Key index.
manualPan
String
No
Flag to enable/disable manual card number entry.
avs
String
No
Flag to enable/disable Address Verification Service (AVS).
avsStreetAddress
String
No
AVS setting for street address.
avsPostalCode
String
No
AVS setting for postal code.
avsCvv2
String
No
AVS setting for CVV2.
modifyCompleteAmount
String
No
Configuration for modifying completion amount.
modifyReversalAmount
String
No
Configuration for modifying reversal amount.
partialAuthCap
String
No
Flag for partial authorization capability.
networkAccessIndicator
String
No
The network access indicator.
pinlessPosDebit
String
No
Flag for PIN-less POS debit.
facilitator
String
No
Flag for facilitator setting.
alternateMerchant
String
No
Flag for alternate merchant setting.
refundType
String
No
The type of refund processing.
cashBack
String
No
Flag to enable/disable cash back.
cashDiscount
String
No
Flag to enable/disable cash discounting.
floorLimit
String
No
The transaction floor limit.
contactlessTranLimit
String
No
The limit for contactless transactions.
contactlessFloorLimit
String
No
The floor limit for contactless transactions.
cmvRequiredLimit
String
No
The Cardholder Verification Method (CVM) required limit.
forceSettle
String
No
Flag to force settlement.
closeOfBusinessTime
String
No
The time for automatic end-of-day settlement.
batchNumber
String
No
The current batch number.
transExpiredDays
String
No
The number of days after which a transaction expires.
traceNo
String
No
The current trace number.
receipt
String
No
Receipt printing configuration.
Request Example
{
"clientId": "client12345",
"pushData": {
"terminalSn": "YOUR_TERMINAL_SERIAL_NUMBER",
"fiservMerchantInfo": {
"merchantId": "YOUR_FISERV_MERCHANT_ID",
"terminalId": "YOUR_FISERV_TERMINAL_ID",
"tppId": "RWI012",
"groupId": "20001",
"merchantName": "FISERV TEST MERCHANT",
"merchantAddress": "123 MAIN ST",
"merchantCity": "ANYTOWN",
"merchantState": "GA",
"merchantZip": "30346",
"merchantPhone": "1234567890",
"merchantEmail": "test@example.com",
"countryCode": "840",
"currencyCode": "840"
},
"fiservCommunicationInfo": {
"primaryHostName": "https://prod.dw.us.fdcnet.biz/rc/",
"srsDiscoverHostName": "https://prod.dw.us.fdcnet.biz/sd/srsxml.rc/",
"srsHostName": "https://stagingsupport.datawire.net/nocportal/SRS.do",
"communicationTimeout": "40"
},
"fiservTerminalConfig": {
"adminPass": "99999999",
"superPass": "123456",
"refundPass": "123456",
"reversalPass": "123456",
"tmkIndex": "2",
"manualPan": "1",
"avs": "1",
"avsStreetAddress": "0",
"avsPostalCode": "0",
"avsCvv2": "0",
"modifyCompleteAmount": "0",
"modifyReversalAmount": "0",
"partialAuthCap": "0",
"networkAccessIndicator": "0",
"pinlessPosDebit": "0",
"facilitator": "0",
"alternateMerchant": "1",
"refundType": "0",
"cashBack": "0",
"cashDiscount": "0",
"floorLimit": "0",
"contactlessTranLimit": "999900",
"contactlessFloorLimit": "0",
"cmvRequiredLimit": "10000",
"forceSettle": "0",
"closeOfBusinessTime": "15:33:59",
"batchNumber": "1",
"transExpiredDays": "30",
"traceNo": "1",
"receipt": "2"
}
}
}Response Body
The response acknowledges the request and provides the status of the configuration push.
code
Integer
The HTTP status code. 200 indicates a successful request.
msg
String
A human-readable message. success on successful requests.
timestamp
String
The UTC timestamp of the response. Format: YYYY-MM-DD HH:mm:ss.
data
Object
A container for the successful response data. Null on error.
data.pushId
String
A unique ID for this configuration push operation.
Push Status Codes
0
In Progress (Parameters are being pushed)
1
Success (Parameters were pushed successfully)
2
Failure (Parameter push failed)
Success Response Example
{
"code": 200,
"msg": "success",
"timestamp": "2025-08-12 14:45:54",
"data": {
"pushId": "768206988353077248",
"status": 0
}
}Last updated