Unlinking

Used to unlink the PhonePe account with Merchant account of customer. The userAuthToken is also invalidated. This doesn’t involve any UI flow. Merchant needs to implement their own UI.

Request Headers

Header Name

Header Value

Content-Type

application/json

X-VERIFY

SHA256(base64 encoded payload +
'/v3/merchant/token/unlink' + salt key) +
'###' + salt index

{
 "merchantId": "MID",
 "userAuthToken": "TXN12345"
}
{
 "request" : "ew0KCeKAnG1lcmNoYW50SWTigJ06IOKAnE1JROKAnQ0KCeKAnHVzZXJBdXRoVG9rZW7igJ06IOKAnFRYTjEyMzQ14oCdLA0KfQ0K"
}

Request Parameters

Parameter Name

Type

Description

merchantId

string

Unique merchantId assigned to merchant.

userAuthToken

string

Auth token for the user

Response Parameters

Parameter Name

Type

Description

success

boolean

Denotes if API call is successful.

code

string

See below for list of values

data

Object

See below table

Response Codes

Code Value

Description

SUCCESS

Success scenario

AUTHORIZATION_FAILED

Value of X-VERIFY is incorrect

BAD_REQUEST

Invalid request payload

INTERNAL_SERVER_ERROR

The server is busy or the server is not responding

USER_BLACKLISTED

Customer is blacklisted on PhonePe side

INVALID_USER_AUTH_TOKEN

The userAuthToken provided is either invalid or not mapped to merchant.

Response Data

Parameter Name

Type

Description

merchantId

string

merchantId assigned to merchant.

userAuthToken

string

The disabled Auth token for the user

Language
Click Try It! to start a request and see the response here!