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

Name	Value
Content-Type	application/json
jwt-token	Token Provided by Paywizard
sign	PayWizard Open Platform API Signature Guide V3

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"
}