Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trymaven.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Connecting Fiserv

Maven connects to Fiserv (Commerce Hub / Payments Live) using your API Key and API Secret. These credentials let Maven create charges or vault cards on your behalf.

​
Prerequisites

  • A Fiserv developer account
  • API Key and API Secret
  • A Maven app

​
Getting Your Credentials

1

Register at portal.fiserv.dev

Go to portal.fiserv.dev and complete registration. Verify your email and set up MFA.
2

Navigate to API Keys

Once logged in, go to the API Keys page. A pre-generated Test Sandbox Key is already there with access to all APIs and a dummy Store ID — no approval step needed for sandbox.
3

Copy Credentials

You’ll see:
  • API Key — sent in the Api-Key header on each request
  • API Secret — used as the HMAC-SHA256 secret to sign each request body
For production, follow Fiserv’s separate onboarding flow to get production keys plus your production base URL.

​
Connecting in Maven

1

Go to Payments

In the Maven Dashboard, open your app and click the Payments tab.
2

Click Fiserv

Click the Fiserv card to expand it, then click Connect Fiserv.
3

Enter Credentials

  • Environment: Sandbox or Production
  • API Key: Your Fiserv Api-Key
  • API Secret: Your Fiserv API Secret
  • Production Base URL (optional, production only): Override if Fiserv assigned your tenant a non-default hostname. Leave blank to use the standard hostname.
4

Save

Click Save Credentials. Maven stores them per-environment so you can have sandbox and production keys configured side by side.

​
Sending the form to your customer

If your customer is the merchant (i.e., the Fiserv account is theirs, not yours), click Copy link next to Save. That generates a single-use, 7-day link they can open in a browser and paste their credentials directly into a hosted form. Their keys are written to your project without you ever seeing them.

​
Sandbox Testing

The portal.fiserv.dev sandbox key works immediately on signup — no approval. Use it with mvn_test_ API keys to test without real charges. A useful sandbox test card:
FieldValue
Number4035 8740 0042 4977
ExpiryAny future date
CVV977

​
Processor Response Fields

​
Charge Mode

FieldDescription
fiserv_transaction_idFiserv ipgTransactionId
fiserv_order_idFiserv orderId
fiserv_payment_tokenReusable payment token (returned on every charge — store it for future re-charges)
fiserv_stateCAPTURED (auto) or AUTHORIZED (manual)
fiserv_statusAPPROVED on success
approval_codeFiserv authorization code
response_codeProcessor response code (00 = success)
response_messageProcessor response message
card_brandCard brand (e.g. VISA)
card_last4Last 4 digits

​
Tokenize Mode (Vault)

FieldDescription
fiserv_payment_tokenReusable Fiserv payment token (UUID)
card_brandCard brand
card_last4Last 4 digits
ipg_transaction_idFiserv ipgTransactionId from the tokenization request

​
Using Tokenized Cards

After tokenizing, charge the stored Fiserv paymentToken directly. Each request is HMAC-SHA256 signed: 
import base64, hashlib, hmac, json, time, uuid
import httpx

API_KEY = "your_api_key"
API_SECRET = "your_api_secret"
BASE_URL = "https://prod.emea.api.fiservapps.com/sandbox/ipp/payments-gateway/v2"

body = {
    "requestType": "PaymentTokenSaleTransaction",
    "transactionAmount": {"total": 49.99, "currency": "USD"},
    "paymentMethod": {"paymentToken": {"value": "your-fiserv-payment-token"}},
    "transactionOrigin": "ECOM",
}
body_str = json.dumps(body, separators=(",", ":"))
cri = str(uuid.uuid4())
ts = str(int(time.time() * 1000))
raw = (API_KEY + cri + ts + body_str).encode()
sig = base64.b64encode(hmac.new(API_SECRET.encode(), raw, hashlib.sha256).digest()).decode()

resp = httpx.post(
    f"{BASE_URL}/payments",
    content=body_str,
    headers={
        "Content-Type": "application/json",
        "Api-Key": API_KEY,
        "Client-Request-Id": cri,
        "Timestamp": ts,
        "Message-Signature": sig,
    },
)
print(resp.json())