API template library

Fiserv Suspense Account Management mock API and live sandbox

A WireMock simulation of Fiserv's REST API — covering suspense item creation and clearance, GL and cost-center mappings, clearance rules, and settlement reporting.

Vendor
Fiserv
Functionality
Suspense account management
Spec version
1
Endpoints
151
Stubs
151
Protocol
REST
Validation
AI-validated Before publication, an AI agent exercised these endpoints against the real Fiserv API through WireMock's recording proxy, and the recorded traffic was used to verify each stub's request and response shapes.

Live sandbox · no signup, no API key

Fiserv Issuer Solutions - SAM

A running WireMock Cloud instance of this template, callable right now from a terminal, a script, or an AI agent.

Base URL
https://mj8j3.wiremockapi.cloud

POST Get Settlement Statement Report

curl -s -X POST 'https://mj8j3.wiremockapi.cloud/sam/v1/SettlementStatementReport' \
  -H 'Content-Type: application/json' \
  -d '{}'

POST Get Settlement Summary Report

curl -s -X POST 'https://mj8j3.wiremockapi.cloud/sam/v1/SettlementSummaryReport' \
  -H 'Content-Type: application/json' \
  -d '{}'

POST Get Active Items Report Service

curl -s -X POST 'https://mj8j3.wiremockapi.cloud/sam/v1/activeItemsReportService' \
  -H 'Content-Type: application/json' \
  -d '{}'
Method Path Summary
POST /sam/v1/activeItemsReportService Get Active Items Report Service
POST /sam/v1/activitySummaryByPgttService Get Suspense Account Activity Report Service
POST /sam/v1/addclearancemethods Get Clearance Methods Service
POST /sam/v1/addsam Get Agent Sam Service
POST /sam/v1/adminWindowsAuditReportService Get Admin Windows Audit Report Service
POST /sam/v1/agentinquiry Get Agent Sam Service
POST /sam/v1/agingItemsReportService Get Aging Items Report Service
POST /sam/v1/alphacode Alpha Code Service
POST /sam/v1/alphaCode Get Alpha code Service
POST /sam/v1/alphatrancodestrategy Maintain Alpha/Tran Code Strategy Service
POST /sam/v1/alphatrancodestrategymap Alpha/Tran Code assignment to Strategy Service
POST /sam/v1/alphatranglmapping Alpha/Tran/GL Code Mapping
POST /sam/v1/amexocprocess Get Amex Oc Process Service
POST /sam/v1/amexscreendata Amex Outgoing Charge back Screen Data
POST /sam/v1/assignedadjtypecd Get assigned Adjustment type code
POST /sam/v1/assignedclerkcode Get Assigned Clerk Codes
POST /sam/v1/autoClearanceReportService Get Auto Clearance Report Service
POST /sam/v1/autoclearancerules Auto clearance rules
POST /sam/v1/automatedmemosetup Automated Memo Setup Service
POST /sam/v1/bcmesssage Broadcast messages service
POST /sam/v1/billingreportservice Get Billing Report Service
POST /sam/v1/cardactivatedterminalcode Get terminal code list
POST /sam/v1/cardholderMemoProcess Cardholder Memo Process Service
POST /sam/v1/chargeBackSummaryReportService Get Charge Back Summary Report Service
POST /sam/v1/chargeoffreasoncode Charge Off Reason Code
POST /sam/v1/chartofaccounts Chart of Account Service
POST /sam/v1/chartofaccountsassignment Maintain PG Suspense Type - Assign Chart of Accounts
POST /sam/v1/clearanceAuditReportService Get Clearance Audit Report Service
POST /sam/v1/clearanceinformation Clearance Information Service
POST /sam/v1/clearancelimit Get clearance limits Sam Service
POST /sam/v1/clearancemessage Suspense Account Management Clearance Message
POST /sam/v1/clearancemessagecodes Get Clearance Message Service
POST /sam/v1/clearancemethodassignment Get Clearance Method Assignment Details
POST /sam/v1/clearanceMethodReportService Get Clearance Method Report Service
POST /sam/v1/clearancereason Get Clearance Reason
POST /sam/v1/clearancereasoncodes Get Clearance Reason Service
POST /sam/v1/clearancereasonmessageassignment Clearance Reason Message Assignment
POST /sam/v1/clearancereasons Get Clearance Reason Service
POST /sam/v1/clearclientsuspenseitem Clear Client Suspense Item Details
POST /sam/v1/costcenter Cost Center Service
POST /sam/v1/costcentermapping Cost Center Mapping
POST /sam/v1/createsettlementtransactiontype Create Settlement Transaction Type
POST /sam/v1/createSuspenseItem Create Suspense Item
POST /sam/v1/customalphacode Get Custom alpha code list
POST /sam/v1/custombatchtypecode Get Batch Type codes
POST /sam/v1/customcardtypepromoid Get Card Type Promo Id Details
POST /sam/v1/customportfoliostatisticsmapping Portfolio Management Statistics Mapping
POST /sam/v1/customreward Maintain Reward IDs
POST /sam/v1/customSettlementReportService Get Custom Settlement Statement Report Service
POST /sam/v1/deletehierarchy Delete Hierarchy
POST /sam/v1/documentIndicatorCode Get assigned Document Indicator code
POST /sam/v1/donotprocessclearencemethod Do Not Process Clearance Method
POST /sam/v1/dynamicfeemapping Dynamic Fee Mapping
POST /sam/v1/email Send email to user
POST /sam/v1/evaluateprocess Process Evaluation
POST /sam/v1/expeditedupdateclear Expedited Update Or Clear of Suspense Items
POST /sam/v1/fdccodelist Get FDC Codes List
POST /sam/v1/fdctrancodes Fdc Tran Code List
POST /sam/v1/feerecovery FeeRecoveryMethod
POST /sam/v1/generalLedgerActivityReport Get General Ledger Report to service

+91 more endpoints in the full spec.

Unauthenticated WireMock Cloud demo sandbox for Fiserv — not an official Fiserv sandbox, and it returns simulated example data only.

What's inside the SAM template

SAM — Suspense Account Management — is the accounting desk of Fiserv's issuer platform, where transactions that couldn't post cleanly wait to be researched and cleared. The template's 151 routes map that desk end to end: suspense item creation and expedited clearance, the clearance vocabulary (methods, reasons, message codes, and the assignments binding them), the chart-of-accounts and cost-center mappings that tie suspense types to general-ledger destinations, alpha and tran-code strategies, and a deep reporting shelf — aging items, clearance audit, settlement statements, GL activity. Every response opens with the family's processorInfo header carrying the classic processor coordinates (system 2000, cycle 001), then the party context this API scopes everything to: partyGroupName TEST PARTY GROUP, cross-reference group id 1001. Write acknowledgments return their DTOs with ID001-style placeholder identifiers, and the report routes answer with named, empty result lists — the full reporting contract, awaiting your data.

  • Suspense items — creation, clearance information, expedited update-or-clear, and client-item clearing
  • Clearance vocabulary — methods, reasons, message codes, auto-clearance rules, and their assignment routes
  • GL wiring — chart-of-accounts, cost-center mappings, and settlement transaction types
  • Operating codes — alpha and tran-code strategies, FDC code lists, and clerk and adjustment-type assignments
  • Reporting shelf — aging, active-items, clearance-audit, billing, GL-activity, and settlement statement reports

Frequently asked questions

The tenancy model. SAM scopes its data to party groups — an issuer's organizational slice of the processing system — and each envelope names the group it answered for alongside the numeric cross-reference id real requests must carry. The sandbox pinning both to one canonical group keeps that scoping visible in every parse without requiring you to provision anything, and multi-tenant client code can assert it threads the group context through each call.

Contract-by-contract, yes; as a persisted lifecycle, no. The create acknowledges with a suspense item DTO whose identifiers are placeholder ID001 values, and the clearance routes accept their requests independently — nothing links the two calls, and no item ages between them. That covers request construction and response binding for each step. The full arc — create an item, watch it on the aging report, clear it, see the clearance audit — is scenario work for a private WireMock Cloud copy, where WireMock's stateful scenarios can walk one item across those four contracts.

POSTs because report criteria — date windows, hierarchy selections, code filters — travel in the body across this whole API family; empty because the sandbox ships the report contracts without seeded rows. Each report names its result list (settlementSummaryReportList, emailNotificationsList, and so on), so response wiring is verifiable per report even before a private copy fills them with statement lines shaped like your portfolio's.

Upstream posting activity — and in this library, that upstream is the Operations Execution template, whose adjustments desk models the batch and dual adjustment intakes, per-network chargeback RPCs, and review queues whose exceptions land in suspense. The two surfaces share the same envelope conventions, so a client built against one reads naturally against the other; work the money movement there, and the accounting cleanup here.

Vendor names identify APIs represented by WireMock template sources. This page does not imply vendor endorsement, certification, partnership, or official integration status.