Fiserv Exchange Boarding Service Results Webhook

Summary

This webhook provides boarding results for merchant applications boarded to Fiserv via Infinicept. Within the webhook payload, the NorthMid value is used to associate transactions with merchants within the daily DFM (Data File Manager) imported into Backoffice for funding.

NOTE: The Fiserv Exchange BatchedBoardingResults webhook payload replaces the Fiserv Marketplace BatchedBoardingResults webhook payload. This is in accordance with Fiserv's decision to sunset the Marketplace platform. See an example of the Fiserv Marketplace webhook previously used at the bottom of this page.

Payload Schema

Field	Type	Description
BoardingServiceTitle	String	Expected value: Fiserv Exchange
Status	Integer	The merchant application's boarding status. Values include 1 = WaitingOnResponse, 2 = NeedsAttention, 3 = Declined, and 4 = Completed.
Details	Object	Contains the details of the processor boarding attempt.
BOARDINGREASON	String	A description of the boarding result.
NotesFromProcessor	String	Lists the errors from the processor when boarding needs attention.
PROCESSED DATE TIME	String	The date and time when the merchant application was processed.
OutletInternalMid	Integer	The identifier Fiserv uses during the boarding process. Use this MID for reference when contacting Fiserv for technical support.
OutletExternalId	String	The external outlet identifier, if provided.
NashvilleMid	Integer	A Nashville-assigned merchant ID used for the internal Fiserv hierarchy.
NorthMid	Integer	The merchant identifier created by Fiserv and sent to Infinicept upon boarding. This identifier is used to associate transactions with merchants within the daily DFM (Data File Manager) imported into Backoffice for funding.
ApplicationMid	Integer	The top-level merchant id for the application, sometimes referred to as Merchant MID. This is not used for funding.
SubgroupMid	Integer	The id for the subgroup created under the Application MID.
SubgroupParentMid	Integer	The parent subgroup id, which equals the Application MID.
FiservStatus	String	The merchant's onboarding status in Fiserv. See the expected values listed below this table.
ApplicationReference	Integer	The unique application id in Fiserv. This can be used to locate the application in the Fiserv portal.
MerchantReference	Integer	The unique merchant id in Fiserv. This can be used to locate the merchant in the Fiserv portal.
OrderId	String	The order id associated with the merchant application.
ProductId1	String	The product id assigned to the merchant in Fiserv.
Product1TerminalIdList	String	The list of terminal ids associated with the product.
TerminalId1	Integer	The terminal identification number (TID) requested from Fiserv for configuring terminals, gateways, mobile apps, and more.
TerminalId2	Integer	The terminal identification number (TID) requested from Fiserv for configuring terminals, gateways, mobile apps, and more.
TerminalId3	Integer	The terminal identification number (TID) requested from Fiserv for configuring terminals, gateways, mobile apps, and more.
TerminalId4	Integer	The terminal identification number (TID) requested from Fiserv for configuring terminals, gateways, mobile apps, and more.

FiservStatus expected values:

OPEN, APP_STATUS_AWAITING_CHECKS, AWAITING_SIGNATURE, AWAITING_REMOTE_SIGNATURE, AWAITING_PAPER_SIGNATURE, AWAITING_ON_SCREEN_SIGNATURE, BOARDING_COMPLETE, CANCELLED, APP_STATUS_READY_FOR_MARKETPLACE_SUBMISSION, APP_STATUS_AWAITING_MARKETPLACE_RESPONSE, APP_STATUS_MARKETPLACE_SUBMISSION_ERROR, APP_STATUS_MARKETPLACE_REJECTED, and UNDERWRITING_DECLINED

Example

The example response below describes a merchant application successfully boarded to Fiserv Exchange.

{
      "BoardingServiceTitle": "Fiserv Exchange",
      "Status": 4,
      "Details": {
        "COMPLETED": "0",
        "BOARDINGREASON": "Successfully boarded.",
        "NotesFromProcessor": "",
        "__PROCESSED_DATETIME__": "8/11/2025 9:46:57 PM +00:00",
        "OutletInternalMid": "609900000550681",
        "OutletExternalId": "OTL9E-EB482-0C447-7F761-00C15-027DA-0D49F",
        "NashvilleMid": "208219377883",
        "NorthMid": "288965235213",
        "ApplicationMid": "600100000118606",
        "SubgroupMid": "600200000062310",
        "SubgroupParentMid": "600100000118606",
        "FiservStatus": "BOARDING_COMPLETE",
        "ApplicationReference": "555000110859",
        "MerchantReference": "5043913",
        "OrderId": "nv12K",
        "ProductId1": "56302",
        "Product1TerminalIdList": "7731987, 7731995, 7732001, 7732019",
        "TerminalId1": "7731987",
        "TerminalId2": "7731995",
        "TerminalId3": "7732001",
        "TerminalId4": "7732019"
      }
    }

Previous webhook payload for Fiserv Marketplace

This example is provided for comparison purposes only and is no longer in use.

{
      "BoardingServiceTitle": "First Data Boarding",
      "Status": 4,
      "Details": {
        "BOARDINGREASON": "Successfully boarded.",
        "FUNDINGSCHEDULE": "PayfacFunded",
        "DESIGNATOR01": "Launchpay",
        "ORDERID01": "22yjn",
        "MID01": "208229871887",
        "FIRSTDATAMERCHANTID01": "gpebR",
        "STATUS01": "Terminal Id created",
        "STATUSDETAILS01": "Credit Approved",
        "CORRELATIONID01": "N242135761",
        "PLATFORMCODE01": "FDN",
        "NASHVILLEMID01": "296225611887",
        "FIRSTDATAPOINTOFSALEREQUESTID01": "66512247",
        "PRODUCTID01": "94286",
        "__PROCESSED_DATETIME__": "8/11/2025 1:23:16 PM +00:00",
        "TERMINALID01": "4443489",
        "TERMINALID02": "4383423",
        "PRODUCTID002": "94768"
      }
    }