Before you start
You need:- A Fiserv Commerce Hub merchant account. To test first, create a free account at developer.fiserv.com. The sandbox (Fiserv calls it CERT) is separate from production and has its own keys.
- For live payments, a production account that Fiserv has boarded. Production keys only appear after that.
- Tokenization (TransArmor) enabled on the account, so cards can be saved for upsells and renewals. Ask your Fiserv contact if you are not sure.
Step 1: get your keys from Fiserv Developer Studio
ElasticFunnels needs four values for each environment: the API Key, the API Secret, the Merchant ID and the Terminal ID.- Sign in at developer.fiserv.com and open your workspace.
- Open the Credentials tab.
- Generate a key for the environment you want (sandbox or production).
- Copy the API Key and the API Secret, and note the Merchant ID and Terminal ID shown with them.
Step 2: add the Fiserv merchant
- Go to Merchants → Add Merchant and choose Fiserv (Commerce Hub / Payeezy).
- Fill in the fields. Each one has a hint under it that says where to find the value.
- Use the Live Mode toggle to pick which set of keys is used. With Live Mode off, the Sandbox fields are used and no real card is charged.
- Pick the checkout page the merchant uses.
- Save.
Every field has a Sandbox twin, so you can keep both sets of keys on one merchant and switch with the toggle. Saving does not test the keys. Place a test order with Live Mode off (see Test before you go live) to confirm they work.
Step 3: use it on your checkout
Make Fiserv the merchant of the domain or the funnel, as with any card merchant. See How to set up a new merchant. The card form on your checkout page then loads Fiserv’s secure fields for the card number, expiry month, expiry year and security code. Nothing changes in your page’s code.What the buyer sees
- The buyer fills in their details and types the card into the secure fields.
- They click the button. The payment is approved or declined on the same page.
- After an approval they continue to the next step (an upsell or the thank-you page).
One-click upsells and subscriptions
The first payment saves the buyer’s card with Fiserv as a token. ElasticFunnels keeps only the token and the card’s expiry date, never the card number. With the saved card:
A declined renewal follows your subscription’s retry settings.
Refunds and voids
Refund an order from its page in ElasticFunnels, the same way as for any card merchant. You can refund the full amount or part of it. Fiserv does not send ElasticFunnels notifications about payments. A refund or void you make in the Fiserv portal is not recorded in ElasticFunnels, so refund from ElasticFunnels to keep your reports right. Chargebacks do not reach your reports automatically either.Test before you go live
With Live Mode off, payments go to the Fiserv sandbox (CERT), which simulates approvals and declines. Use the test cards from the Fiserv Developer Studio documentation with any future expiry date. To place test orders on a live merchant without charging a real card, set a Test Key and add?test=[key] to the checkout URL. See Test merchant.