Fiserv Parameter Push

This API is only for Fiserv Varsheet.

ENV	PROTOCOL	METHOD	API URL
UAT	HTTP	POST	https://uat.paywizard.biz/ovstrade/varsheet/fiservwizarpos/configuration/push
PROD	HTTP	POST	https://portal.paywizard.biz/ovstrade/varsheet/fiservwizarpos/configuration/push

Http Header

Content-Type:application/json
jwt-token:Developer Token

Request

VAR	NAME	MANDATORY	TYPE	DESC
clientId	Developer ID		String
pushData	Push Data		Object
terminalSn	Terminal Serial Number		String	Manufacturer's Device Serial Number
fiservMerchantInfo	fiservMerchantInfo		Object
--merchantId	merchantId		String
--terminalId	terminalId		String
--tppId	tppId		String
--groupId	groupId		String
--merchantName	merchantName		String
--merchantAddress	merchantAddress		String
--merchantCity	merchantCity		String
--merchantState	merchantState		String
--merchantZip	merchantZip		String
--merchantPhone	merchantPhone		String
--merchantEmail	merchantEmail		String
--countryCode	countryCode		String
--currencyCode	currencyCode		String
fiservCommunicationInfo	fiservCommunicationInfo		Object
--primaryHostName	primaryHostName		String
--srsDiscoverHostName	srsDiscoverHostName		String
--srsHostName	srsHostName		String
--communicationTimeout	communicationTimeout		String
fiservTerminalConfig	fiservTerminalConfig		Object
--adminPass	adminPass		String
--superPass	superPass		String
--refundPass	refundPass		String
--reversalPass	reversalPass		String
--TMKIndex	TMKIndex		String
--manualPan	manualPan		String
--avs	avs		String
--avsStreetAddress	avsStreetAddress		String
--avsPostalCode	avsPostalCode		String
--avsCvv2	avsCvv2		String
--modifyCompleteAmount	modifyCompleteAmount		String
--modifyReversalAmount	modifyReversalAmount		String
--partialAuthCap	partialAuthCap		String
--networkAccessIndicator	networkAccessIndicator		String
--pinlessPosDebit	pinlessPosDebit		String
--facilitator	facilitator		String
--alternateMerchant	alternateMerchant		String
--refundType	refundType		String
--cashBack	cashBack		String
--cashDiscount	cashDiscount		String
--floorLimit	floorLimit		String
--contactlessTranLimit	contactlessTranLimit		String
--contactlessFloorLimit	contactlessFloorLimit		String
--cmvRequiredLimit	cmvRequiredLimit		String
--forceSettle	ForceSettle		String
--closeOfBusinessTime	closeOfBusinessTime		String
--batchNumber	batchNumber		String
--transExpiredDays	transExpiredDays		String
--traceNo	traceNo		String
--receipt	receipt		String

Request Sample:

{
	"clientId": "client12345",
	"pushData": {
		"terminalSn": "YOUR_TERMINAL_SERIAL_NUMBER", // Required: Terminal serial number, used to specify the target terminal for the push 
		"fiservMerchantInfo": {
			"merchantId": "YOUR_FISERV_MERCHANT_ID", // Required: Fiserv Merchant ID 
			"terminalId": "YOUR_FISERV_TERMINAL_ID", // Required: Fiserv Terminal ID
			"tppId": "RWI012", // May be provided in Fiserv varsheet
			"groupId": "20001", // May be provided in Fiserv varsheet
			"merchantName": "FISERV TEST MERCHANT",
			"merchantAddress": "123 MAIN ST",
			"merchantCity": "ANYTOWN",
			"merchantState": "GA",
			"merchantZip": "30346",
			"merchantPhone": "1234567890",
			"merchantEmail": "[e-mail]",
			"countryCode": "840", // Default value 840 (USD); 
			"currencyCode": "840" // Default value 840 (USD); 
		},
		"fiservCommunicationInfo": {
			"primaryHostName": "https://prod.dw.us.fdcnet.biz/rc/", // Primary Hostname
			"srsDiscoverHostName": "https://prod.dw.us.fdcnet.biz/sd/srsxml.rc/", // SRS Discover Hostname
			"srsHostName": "https://stagingsupport.datawire.net/nocportal/SRS.do", // SRS Hostname
			"communicationTimeout": "40" // Communication Timeout
		},
		"fiservTerminalConfig": { // Terminal-specific configuration, directly mapped to fields in Fiserv_wizarpos_cfg_20250718.xml
			"adminPass": "99999999", // Default value
			"superPass": "123456", // Default value
			"refundPass": "123456", // Default value
			"reversalPass": "123456", // Default value
			"TMKIndex": "2", // Default value
			"manualPan": "1", // Default value
			"avs": "1", // Default value
			"avsStreetAddress": "0", // Default value
			"avsPostalCode": "0", // Default value
			"avsCvv2": "0", // Default value
			"modifyCompleteAmount": "0", // Default value
			"modifyReversalAmount": "0", // Default value
			"partialAuthCap": "0", // Default value
			"networkAccessIndicator": "0", // Default value
			"pinlessPosDebit": "0", // Default value
			"facilitator": "0", // Default value
			"alternateMerchant": "1", // Default value
			"refundType": "0", // Default value
			"cashBack": "0", // Default value
			"cashDiscount": "0", // Default value
			"floorLimit": "0", // Default value
			"contactlessTranLimit": "999900", // Default value
			"contactlessFloorLimit": "0", // Default value
			"cmvRequiredLimit": "10000", // Default value
			"ForceSettle": "0", // Default value
			"CloseOfBusinessTime": "15:33:59", // Default value
			"batchNumber": "1", // Default value
			"transExpiredDays": "30", // Default value
			"traceNo": "1", // Default value
			"receipt": "2" // Default value
		}
	}
}

Response

NAME	VAR	MANDATORY	TYPE	EXAMPLE	DESC
Return Code	code		Int	200	Return code 200 indicates a normal transaction; any code other than 200 indicates an abnormal transaction.
Return Msg	msg		String	success
Return Data	data		Object
Push ID	--pushId		String
Push Status	--status		Integer		0: Parameter push in progres 1: Parameter push successful 2: Parameter push failed
Data/Time(UTC)	timestamp		String	2024-07-23 17:57:00

Response Sample:

{
    "code": 200,
    "msg": "success",
	"data": {
        "pushId": "768206988353077248",
		"status": 0
    },
    "timestamp": "2024-08-12 14:45:54"
}