Integration Guide
Service Routing
Which M2P microservice handles which API operations — routing guide for partner integrations.
Understanding which service to call for each operation is critical for successful integration.
Service-to-API Mapping
Base Path: /configs/
Configuration service for products, BINs, corporates, fees, and exchange rates.
| API Group | Endpoints | Purpose |
|---|---|---|
| Products | /v1/products/* | Product CRUD, configuration, approval |
| BIN Ranges | /v1/bin-ranges/*, /v1/add/bin-ranges | BIN range management |
| Corporates | /v1/corporates/* | Corporate CRUD, product mapping |
| Fees | /v1/fees/* | Fee structure configuration |
| Exchange Rates | /v1/exchange-rate/* | Forex rate management |
| Nostro Accounts | /v1/nostro/* | Nostro account configuration |
| Vendors | /v1/vendors-embossing/* | Card vendor/embossing setup |
| Geo Location | /v1/geo-location/* | State/city configuration |
| Purpose of Travel | /v1/purpose-of-travel/* | Forex travel purposes |
Base Path: /customer/
Customer lifecycle service for customers, cards, wallets, transactions, UPI, and IMPS.
| API Group | Endpoints | Purpose |
|---|---|---|
| Customers | /v1/customers/* | Customer CRUD, search, KYC, activation |
| Cards | /v1/cards/* | Card operations (PIN, status, preferences, view) |
| Wallets | /v1/wallets/* | Balance inquiry, load, transfer, limits |
| Transactions | /v1/transactions/* | Transaction search, statement, reversal |
| UPI | /v1/upi/* | UPI registration, VPA, payments |
| IMPS | /v1/imps/* | Beneficiary management, transfers |
| OTP | /v1/otp/* | OTP generation and validation |
| Disputes | /v1/disputes/* | Dispute management |
| Lien | /api/lienmark | Balance hold management |
Base Path: /corporate/
Issuance and corporate operations for all card/wallet programs.
| API Group | Endpoints | Purpose |
|---|---|---|
| Corporate Issuance | /v1/corporate-issuances/* | Bulk and individual card issuance |
| Forex Issuance | /v1/forex/issuance/* | Multi-currency travel card issuance |
| Forex Loads | /v1/forex/card-holder-loads/* | Forex wallet load/unload |
| Forex Summary | /v1/forex/summary/* | Balance and fee summary |
| Wallet Issuance | /v1/wallet-issuances/* | Digital wallet issuance |
| Branch Issuance | /v1/branch-issuances/* | Over-the-counter issuance |
| Gift Coupons | /v1/gift-coupons/* | Gift card management |
| Card Renewal | /v1/issuance/card-renewal/* | Card renewal processing |
| Card Replacement | /v1/issuance/card-replacement/* | Card replacement processing |
| Card Actions | /v2/cardActions/* | Unified card status actions (maker-checker) |
| Card Tracking | /v1/card/live-tracking/* | Physical card delivery tracking |
Interactive OpenAPI documentation is available at each service's /api-docs endpoint. See the API Library for complete endpoint reference.