m2pfintech
API LibraryWallet Management

Fetch Wallet Linked Services

Retrieves the list of services linked to the wallet for a given kit and wallet type. Services represent transit or payment networks that are enabled on the NCMC wallet such as metro systems, bus networks, or other mobility services.

POST
/wallet/fetch/services

Authorization

tenantAuth
tenant<token>

The DCMS tenant name for multi-tenant isolation. Every API call must include this header to identify the client organization.

In: header

Header Parameters

tenant*string

The DCMS client or tenant name for multi-tenant isolation.

Request Body

application/json

kitNo*string

Unique kit number identifying the card.

entityId*string

Customer entity identifier who owns the wallet.

walletType*string

Type of wallet to query services for. Currently supports NCMC wallet type.

Value in"NCMC"

Response Body

application/json

curl -X POST "https://api.dcms.example.com/v1/wallet/fetch/services" \  -H "tenant: ACME_BANK" \  -H "Content-Type: application/json" \  -d '{    "kitNo": "4241220463",    "entityId": "828826",    "walletType": "NCMC"  }'
{
  "result": {
    "entityId": "878826",
    "kitNo": "4240220463",
    "services": [
      "Mumbai Metro",
      "Chennai Metro"
    ],
    "walletType": "NCMC"
  },
  "exception": null,
  "pagination": null
}