Generate Token using Merchant's Credentials API

This API is used to generate the authentication token using the merchant's credentials like username and password. You must pass the generated token as the value of the Authorization header for all Payout APIs.

HTTP Method: POST

Request parameters

ParametersDescriptionExample
client_id
mandatory
StringIndicates the Client ID received after logging into Payouts Dashboard and OTP verification.9fe75ea34c2bf34c9d6231732697a8ae8a0 3b4dfcd591d2ca14fcd95410ecca7
grant_type
mandatory
StringThis parameter will contain the Constant valuepassword
username
mandatory
StringThis parameter will contain the registered mobile number or Email ID.[email protected]
password
mandatory
StringThis parameter will contain the registered Account passwordTester@123
scope
mandatory
StringThis parameter will contain the Constant value.create_payout_transactions

📘

Note:

Use the client_id value mentioned above to proceed because the public Client ID remains the same for all Payouts Merchants.

Sample Request

curl -X POST \
 https://uat-accounts.payu.in/oauth/token \
 -H 'cache-control: no-cache' \
 -H 'content-type: application/x-www-form-urlencoded' \
 -d 'grant_type=password&scope=create_payout_transactions&client_id=6f8bb4951e030d4d7349e64a144a534778673585f86039617c167166e9154f7e&username=payouttest4%40mailinator.com&password=Tester%40123&='

Response parameters

KeyDescription
access_tokenIndicates the Security Token used to get access in Payouts API calls.
token_typeType of authorization token
expire_inIndicates the TTL, i.e., the time limit (in seconds) after which the Security Token will expire
refresh_tokenUsed to refresh the access_token. For more information, refer to Refresh Token.
scopeRepresents the allowed scopes in the generated security token. For example, the generated token can be used only for Payouts API requests
created_atIndicates the Time of Creation in milliseconds
user_uuidIndicates the Unique Identifier for the user.

Sample response

{
 "access_token": "581b0657b38a56bb4296f774852f208f6d84a23d8f1bf61c63c15de60d43ee76",
 "token_type": "Bearer",
 "expires_in": 7199,
 "refresh_token": "ff8e094ecfa11fb390931f779ae62c0836f97bbaedcf5551c88eff826da3239a",
 "scope": "create_payout_transactions",
 "created_at": 1585216027,
 "user_uuid": "11e8-5a8f-05faaaa4-84a5-020d245326e4"
}