NPCI Bharat BillPay Limited (A wholly owned subsidiary of NPCI) Registred Office: 1001 A, The Capital, B Wing, 1Ot" Floor, Bandra Kurla Complex, Bandra (E), Mumbai 400 051. T: +91 22 40009100 F: +91 22 40009101 Email id: bbps@npci.org.in Website: www.bharatbiIIpay.com CIN: U6719OMH2O2OPLC351595 Annexure: Biller Fetch MDM API Introduction Bharat Bill Payment System (BBPS) has launched new features viz. UPMS and Clickpay and new category viz. B2B Payments. Unified Presentment Management System (UPMS) – This will enable the COUs to extend the facility of registering for recurring payment mandates to customers making bill payments on their platform. Mandates can be collected for all billers that are enabled on UPMS feature. Clickpay – Customers will be guided to bill payment screen in the COU App by clicking on a link (URL) sent to them over SMS, email, WhatsApp etc. Once the customer clicks on the ClickPay link, the information embedded in the link is read by the COU/AI App and displayed to the customer. Customer reviews the displayed bill details and thereafter proceed to make the payment, without the need of typing any detail. B2B Category – Under this category invoice payment would be facilitated in which any seller would be able to collect receivables from his buyer. For eg. A retailer would be able to make invoice payments to his distributor or a distributor would be able to make invoice payments to his manufacturer or brand owner. For this category, BBPS has introduced multiple invoice fetch and payment under a single transaction Bharat Bill Payment System (BBPS), as part of its API suit, offers an API, called Biller MDM API, to retrieve the configuration details of the billers. With the launch of new features mentioned above, we have added new optional tags to the Biller MDM Request and Response APIs, which would help identify the billers that are enabled for UPMS & Clickpay. For B2B Category, the biller MDM API would provide additional details specific to B2B billers and optional tags have been introduced for same. The purpose of this circular is to share the details of the new tags added to biller MDM API Request & Response. API Details These changes have been implemented for both version 1.0 and version 2.0 of Biller MDM APIs URL: POST /BillerFetchRequest/1.0/urn: referenceId:{referenceId} URL: POST /BillerFetchRequest/2.0/urn: referenceId:{referenceId} Specifications: Biller MDM Request API tags: (i)  This is to filter and return data for only those billers that support the features listed. Initiator can send multiple commas separated values too. This is an Optional Tag. Currently, this supports the values: “Clickpay”, “Upms” Note: a) A combination of any of the optional tags , , or can be used to as per required filters to get customised results in Biller MDM API version 1.0 b) Optional tags , , or can also be used with pagination in order to get customized results in Biller MDM API version 2.0 NPCI Bharat BillPay Limited Biller MDM Response API tags: (i) (ii) (iii) (iv)  This flag indicates whether the biller is enabled for UPMS. All records for UPMS enabled billers will mandatorily have this flag, for other biller records, it is an Optional Tag.  This is an optional tag to pass biller specific parameters required at time of registration.  This flag indicates whether the biller is enabled for Clickpay. All records for Clickpay enabled billers will mandatorily have this flag, for other biller records, it is an Optional Tag.  This indicates the clickpay link that biller is enabled for. Default value is ‘L3PL’. This is an Optional tag. Note: a. The tags enlisted above will be passed in Biller MDM Response for billers enabled on UPMS and/or Clickpay respectively, irrespective whether initiating entity has used the filter in Biller MDM Request or not. b. The tags enlisted above will be passed in Biller MDM Response for all billers. Where the billers are not enabled for the feature, the tag will be passed with value ‘False’. (v) (vi)  For B2B Category Billers, this will indicate the sub category of the respective biller. All records for B2B billers will mandatorily have this flag, for other biller records, it is an Optional Tag.  This is an existing tag with a new accepted value ‘List’ for all B2B Category billers. This indicates that the Bill Fetch Response will contain multiple blocks containing details of multiple invoices to be paid. Other Configuration Changes: (vii)  If this flag is ‘True’ then tag will be blank (tag will be passed with no value). If the flag is ‘False’ then tag will be passed with respective value – ‘EXACT’, ‘EXACT_UP’, ‘EXACT_DOWN’. NPCI Bharat BillPay Limited API Specifications XML Schema Definition XSD for Biller MDM Fetch Request BBPS Biller Fetch Request NPCI Bharat BillPay Limited XSD for Biller MDM Fetch Response BBPS Biller Fetch Response NPCI Bharat BillPay Limited NPCI Bharat BillPay Limited NPCI Bharat BillPay Limited NPCI Bharat BillPay Limited NPCI Bharat BillPay Limited Sample Request / Response: Biller MDM Fetch Request Sample (v2.0 with Pagination) Upms,Clickpay 12 Biller MDM Fetch Request Sample DUMM00000NATTY dummy dummy Broadband Postpaid OFFLINEA SINGLE false false PSU IND MANDATORY Exact NOT_SUPPORTED 2019-11-08 2019-11-27 Internet Banking 1 NPCI Bharat BillPay Limited Debit Card 1 Credit Card 1 Prepaid Card 1 IMPS 1 Cash 1 UPI 1 Wallet 1 NEFT 1 AEPS 1 Account Transfer 1 Bharat QR 1 USSD 1 INT 1 INTB 1 MOB 1 MOBB NPCI Bharat BillPay Limited 1 POS 1 MPOS 1 ATM 1 BNKBRNCH 1 KIOSK 1 AGT 1 BSC 1 AAA NUMERIC false true BBB NUMERIC true true BASE_BILL_AMOUNT ACTIVE No No NOT_SUPPORTED true Vehicle Registration Number (VRN) ALPHANUMERIC false 5 30 true true NPCI Bharat BillPay Limited L3PL YESB00000NATKL dummy dummy B2B AGRO ONLINE LIST true false VODA1P1234 PSU IND OPTIONAL NOT_SUPPORTED 2016-07-08 2023-11-30 IMPS 1 Yes Wallet 1 Yes Credit Card 1 Yes Debit Card 1 Yes Cash 1 Yes Prepaid Card 1 Yes Internet Banking 1 Yes NEFT 1 Yes NPCI Bharat BillPay Limited UPI 1 Yes MOB 1 Yes MPOS 1 Yes INT 1 Yes POS 1 Yes BNKBRNCH 1 Yes KIOSK 1 Yes ATM 1 Yes INTB 1 Yes Customer Reference Number NUMERIC false true Customer Account Number NUMERIC true true BASE_BILL_AMOUNT Late Payment Fee NPCI Bharat BillPay Limited Fixed Charges Additional Charges Adjustments Late Payment Fee BASE_BILL_AMOUNT BASE_BILL_AMOUNT Fixed Charges Additional Charges BASE_BILL_AMOUNT BASE_BILL_AMOUNT Adjustments Late Payment Fee BASE_BILL_AMOUNT Fixed Charges ACTIVE No Yes 100 NOT_SUPPORTED true true L3PL NPCI Bharat BillPay Limited