Customized Deeplink API

<html-block html=”

Request Headers

“>

Header NameHeader Value
Content-Typeapplication/json
X-VERIFYSHA256(base64 encoded payload + “/v3/deeplink” + salt key) + ‘###’ + salt index
X-CLIENT-IDThe default value will be merchant ID which will be unique for each merchant.
{ "request": "ewoJInR5cGUiOiAiV0VCIiwKCSJ1dG1QYXJhbXMiOiB7CgkJInNvdXJjZSI6ICJzb3VyY2UiLAoJCSJtZWRpdW0iOiAibWVkaXVtIiwKCQkiY2FtcGFpZ24iOiAiY2FtcGFpZ24iCgl9LAoJImFwcFVuaXF1ZUlkIjogIk1FUkNIQU5UXzEyMzQzX1RSIiwKCSJhcHBFbnRyeUluZm8iOiB7CgkJInR5cGUiOiAiSFRUUCIsCgkJInVybCI6ICJodHRwOi8vd3d3Lm1lcmNoYW50cGF5bWVudHBhZ2UuY29tIgoJfQp9" }

<html-block html=”

Request Parameters

“>

Parameter NameTypeDescriptionMandatory
typeSTRINGThe default value will be WEBYes
sourceSTRINGSource name, in case merchants wants to know the source of the deeplink.Optional
mediumSTRINGMedium name. If a merchants wants to know what is the medium – website etc.Optional
campaignSTRINGName of the campaignYes
appUniqueIdSTRINGA unique ID which will be shared by the Phonepe teamYes
typeSTRINGThe default value will be HTTPSYes
urlSTRINGThe dynamic URL on which a user will be redirected to after clicking on the deeplink.Yes

<html-block html=”

Response Parameters

“>

Parameter NameTypeDescription
successBOOLEANSuccess status of the request
codeENUMSee list of response codes below
dataObjectThe URL received in the response is needed to be send on the message so the user.

<html-block html=”

Response Codes

“>

CodeDescription
AUTHORIZATION_FAILEDIncorrect X-VERIFY header
INTERNAL_SERVER_ERRORSomething went wrong
{“method”:”post”,”url”:”/v3/deeplink”,”auth”:”required”,”results”:{“codes”:[{“name”:””,”code”:”{\n \”success\”: true,\n \”data\”: {\n \”url\”: \”https://preprod.phon.pe/akk1hzl5\”\n }\n}\n”,”language”:”json”,”status”:200},{“name”:””,”code”:”{}”,”language”:”json”,”status”:400}]},”params”:[{“name”:”X-VERIFY”,”type”:”string”,”enumValues”:””,”default”:””,”desc”:”SHA256(base64 encoded payload + \”/v3/deeplink\” + salt key) + “###” + salt index”,”required”:false,”in”:”header”,”ref”:””,”_id”:”5f364b79353a87001e3411e4″},{“name”:”X-CLIENT-ID”,”type”:”string”,”enumValues”:””,”default”:””,”desc”:”The default value will be merchant ID which will be unique for each merchant.”,”required”:false,”in”:”header”,”ref”:””,”_id”:”5f364b79353a87001e3411e3″},{“name”:”Content-Type”,”type”:”string”,”enumValues”:””,”default”:””,”desc”:”application/json”,”required”:false,”in”:”header”,”ref”:””,”_id”:”5f364b79353a87001e3411e2″}],”examples”:{“codes”:[]},”apiSetting”:”5da600be463ecf036287d7f3″}
https://apps-uat.phonepe.com