Skip to main content
TPAP resolves a VPA address to find the name of the entity to which the VPA belongs and its source before collecting a payment. Below are the expected responses:
  • Payment source information such as name, ifsc and upi_iin are sent in response only when NPCI responds to switch as the VPA is verified.
  • isMerchantVerified, mcc and merchantType are sent in response only when the VPA of a merchant is verified.
Use this endpoint to Resolve a VPA.

​
Request

Curl

​
Response

Response

​
Parameters

vpa mandatory : string VPA that is to be resolved. device optional : string Device details. ip : string The IP address of the device. geocode : string The location coordinates of the device. For example, 12.9667,77.5667.

​
Parameters

entity : string Name of the entity. upi_transaction_id : string The transaction identifier of UPI. address : string The VPA address being resolved. fundsource : object The payment source details. customer_name : string Name of the account holder. ifsc : string IFSC of the account linked to the VPA. upi_iin : string UPI Issuer Identification Numbers (IIN) of the payment source provider issued by NPCI. is_merchant_vpa : boolean Indicates whether the VPA belongs to merchant. Possible values:
  • true: Merchant VPA.
  • false: Not merchant VPA.
is_merchant_verified : boolean Indicates whether merchant is verified. Possible values:
  • true: Merchant is verified.
  • false: Merchant is not verified.
mcc : string The merchant category code for the merchant. merchant : object Business details. identifier : object Merchant identifier details. subcode : string The merchant sub code. This is populated only when the VPA is from the merchant. mid : string The merchant identifier. This is populated only when the VPA is from the merchant. sid : string The SID of the merchant. This is populated only when the VPA is from the merchant. tid : string The TID of the merchant. This is populated only when the VPA is from the merchant. merchant_type : string Type of the merchant. This is populated only when the VPA is from the merchant. merchant_genre : string This is populated only when the VPA is from the merchant. onboarding_type : string The onboarding type. This is populated only when the VPA is from the merchant. name : object The merchant business details. brand : string The merchant brand. This is populated only when the VPA is from the merchant. legal : string The merchant legal information. This is populated only when the VPA is from the merchant. franchise : string The merchant franchise. This is populated only when the VPA is from the merchant. ownership : object The ownership details. type : string The ownership type. feature_tags : string Indicates an array of feature values. Each has its significance as decided by NPCI. Possible values:
  • mandate
  • credit
  • ppi
  • uod
  • voucher