Multiple MID Support for Customers

We have introduced support for multiple Merchant IDs (MIDs), enabling customers to seamlessly manage multiple merchant and sub-merchant accounts within a single integration.

Currently, the customers are identified based on authorisation, but with this enhancement, customers can pass an MID in request headers to specify the merchant or sub-merchant context for various API operations.

Key Enhancements:

1. MID-Based Selection

• Customers can now pass MID in the request headers to determine the merchant or sub-merchant context for
  • User Creation
  • Prefunding
  • Order Creation
  • Order Details Retrieval
  • Balance Fetching
• If MID is not provided in the headers, the default MID assigned for the Customer will be used.
• Users must be explicitly created for each MID, even if they exist in other MIDs of the Customer.
• New Request Field: mid (optional) in request headers.

2. Error Handling

   Case	Error Code	HTTP Status
   MID is passed, but not linked to the customer	MID_NOT_FOUND	404 Not Found
   MID is passed, but is disabled	MID_DISABLED	401 Unauthorized

   
   

3. Dashboard Updates

• If MID is provided → Returns details of the specified MID’s organization.
• If MID is not provided → Returns aggregated details across all linked MIDs.

4. Dashboard Updates

   Dashboard will have the new column MID on the Users and Orders masters and the view can be filtered with the new column MID.

5. Why This Matters?

• Unified Account Management: Customers no longer need to create separate accounts for each MID. A single account can now handle multiple MIDs efficiently.
• Seamless API Integration: Customers can maintain a single API integration and differentiate transactions, balances, and users by passing an MID in headers.
• Improved Dashboard Experience: Customers can view and manage balances across all MIDs in one dashboard, eliminating the need to switch between multiple accounts.
• Flexibility for Business Expansion: Customers can easily request additional MIDs for their merchants or sub-merchants as needed.
• Future Enhancements: This implementation lays the foundation for future capabilities, including inter-MID balance transfers (not included in this release).

Impact on Existing Customers:

• Backward Compatibility: No breaking changes. The existing integration will work without any abruption.
• MID issuance: We will start issuing the MIDs for customers who already had multiple MIDs through different accounts. Customers can migrate to the new MIDs without affecting the current integration, and all other accounts will remain active until the migration is completed on the customer's end.

Live Date: 04-March-2025