💻
Payouts Integration
  • Introduction
  • Functional overview
  • Onboarding
  • Postman Collection
  • Authentication
  • Authentication Token
    • API to Generate Token using username/password
    • API to Generate Token using private client id
  • Refresh Tokens
    • Refresh Token API
  • IP Check
  • API Integration
  • Testing Credentials
  • API Flow Diagram
  • Beneficiary Management
    • View Beneficiary Detail
    • Beneficiary Creation / Registration
  • Core Payouts API
    • Get Account Details API
    • Cancel Transfer API
    • Check Transfer Status API
    • Initiate/Schedule Transfer API
  • Verification
    • Verify Account / Penny Test
    • Validate Vpa
    • IFSC Details
  • smart send
    • Feature
    • Smart Send API
      • Cancel Smart Send
      • Smart Send Status
    • Smart Send V2 API
      • Create Smart Send Link
      • Smart Send Status
      • Cancel Smart Send
      • Extend Expiry Date
    • Bulk Smart Send
      • Bulk File Upload
      • Bulk Process File
    • Smart Send Error Codes
    • Fetch masked Vpas
  • Webhooks
    • What are Webhooks?
    • Default Webhooks
    • Creating Webhooks
    • Set Webhook API
    • Types of webhooks
  • Settings
    • Disable queued Payout
  • FAQ
Powered by GitBook
On this page
  • Request Header Params
  • Request Params
  • Example

Was this helpful?

  1. Verification

Validate Vpa

Validate that UPI address is valid or not. If it is a valid you will get the name against UPI address

PreviousVerify Account / Penny TestNextIFSC Details

Last updated 4 years ago

Was this helpful?

Request Header Params

Key

Description

Data type

Mandatory

possible Values

Authorization

Access token generated earlier.

String

Yes

Bearer {access_token}

payoutMerchantId

This is the merchant id provided while on-boarding

String

Yes

payountMerchantId is different from payumoney merchant id, please check payouts dashboard or call customer support if you don’t know your payoutsMerchantID

Request Params

Key

Description

Data type

Mandatory

possible Values

vpa

UPI address to verify

String

Yes

Example

Sample Request :

curl -X POST \
  https://test.payumoney.com/payout/merchant/validateVpa \
  -H 'authorization: bearer 06aadbs9dac905b5deb7ad844390e0feae784a0ebc03a047aea72fc57b57012d' \
  -H 'cache-control: no-cache' \
  -H 'content-type: application/x-www-form-urlencoded' \
  -H 'payoutmerchantid: 1111111' \
  -d vpa=AMZN0002639304%40apl

Response :

{
    "status": 0,
    "msg": "vpa available",
    "code": null,
    "data": {
        "message": null,
        "name": "ANKUSH POKARANA"
    }
}
{
    "status": 1,
    "msg": "vpa not available",
    "code": null,
    "data": {
        "message": "UPI address is invalid",
        "name": null
    }
}

https://payout.payumoney.com/payout/merchant/validateVpa
https://test.payumoney.com/payout/merchant/validateVpa