validate_upi_vpa
Verify a UPI VPA's structure and identify known provider handles before routing payments. Unknown handles are reported without false rejection, reflecting evolving NPCI lists.
Instructions
Validate UPI VPA structure and decode known provider handles.
Use when checking whether a UPI address is structurally valid before payment routing.
Args: vpa: UPI virtual payment address in username@handle format.
Returns: Standard envelope containing normalized VPA, known_provider flag, and provider metadata.
Notes: Unknown handles are not auto-invalidated because NPCI handle lists evolve over time.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"vpa": "<vpa>"
},
"name": "validate_upi_vpa"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vpa | Yes | UPI VPA, example: user@okaxis |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||