Add Fiserv to your payments ecosystem
To connect to the gateway, you should apply for a merchant account with Fiserv. You can apply for a test account here. To obtain a live merchant account, you should first contact their support team and go through the onboarding process.
Step 1: Gather your credentials from Fiserv
Gather your credentials from Fiserv. Along with your API Store ID, User ID, and password, you will also need certificate files in PEM format and a certificate passphrase from Fiserv.
Step 2: Connect Fiserv to your Paydock Account
- Log into your Paydock Production or Sandbox account;
- Navigate to Services from the menu on the left;
- Click on the Add New tab from the top of the page;
- Navigate to or search Fiserv and click on the Activate button;
- Complete the field descriptions to connect. Field descriptions are as follows:
a. Label – this is for your reference only. In Paydock, you are able to add multiple instances of a payment gateway or method. This can be helpful for tracking campaigns or income streams.
b. Private Key - this is a Client Certificate Private Key stored in a key file having the naming scheme WSstoreID._.userID.key. You will need to open this file (with Notepad on Windows and TextEdit on MacOS) and copy the whole code block including the tags -----BEGIN RSA PRIVATE KEY----- and -----END RSA PRIVATE KEY-----.
c. Username - this is your Fiserv API username which consists of Store ID and User ID provided in the format: WSstoreID._.userID.
d. Password - this is your Fiserv API password required for basic authentication.
e. Certificate - this is a Client Certificate PEM File stored in a PEM file having the naming scheme WSstoreID._.userID.pem. You will need to open this file (with Notepad on Windows and TextEdit on MacOS) and copy the whole code block including the tags -----BEGIN CERTIFICATE----- and -----END CERTIFICATE-----.
f. Select Environment Mode – this describes whether you are connecting to a Fiserv Production or Sandbox Environment. Production is used for processing real transactions. Sandbox is used for testing purposes. Please ensure you’re using the correct credentials for the type of environment required.
g. Certificate Passphrase - this is a Client Certificate Private Key Password. This password protects the private key of the client certificate and is needed to access the private key file. It follows the naming scheme ckp_creationTimestamp.
h. Multicurrency Account - check this box if your Fiserv account supports the multicurrency setup
i. Account Currency - choose the default currency of your Fiserv account if it supports the known multicurrency setup.
- Click Connect. You have successfully connected Fiserv to Paydock!
If you would like to create a gateway via API, feel free to use this guide.