UI Callback

  • The UI Callback response is sent to a URL that is passed in redirectUrl along with the request.
  • The value of the redirectMode can be either REDIRECT or POST to get a UI callback.

For redirectMode as POST, Merchant’s URL should be capable of handling the POST method and accepting the Form Post Response. Once the Form Post response is received, merchant can check the status in their backend server and accordingly redirect the user to the respective payment status page.

Form Post Response Payload

Parameter NameDescription
code
Enum
Response Code
Note: Merchants should not use this to update the payment status. Instead rely only on the Wehbook or Check Status API response.
merchantId
String
merchantId
transactionId
String
Merchant Transaction ID
amount
Long
Transaction amount in paise
providerReferenceId
String
PhonePe Generated ReferenceId.
merchantOrderId
String
Merchant Order Id.
param1
String
Optional Parameter, to be used later
param2
String
Optional Parameter, to be used later
param3
String
Optional Parameter, to be used later
param4
String
Optional Parameter, to be used later
param5
String
Optional Parameter, to be used later
param6
String
Optional Parameter, to be used later
param7
String
Optional Parameter, to be used later
param8
String
Optional Parameter, to be used later
param9
String
Optional Parameter, to be used later
param10
String
Optional Parameter, to be used later
param11
String
Optional Parameter, to be used later
param12
String
Optional Parameter, to be used later
param13
String
Optional Parameter, to be used later
param14
String
Optional Parameter, to be used later
param15
String
Optional Parameter, to be used later
param16
String
Optional Parameter, to be used later
param17
String
Optional Parameter, to be used later
param18
String
Optional Parameter, to be used later
param19
String
Optional Parameter, to be used later
param20
String
Optional Parameter, to be used later
checksum
String
The checksum for this entire request

Merchants should consider the UI Callback as the user completed the action on the PhonePe Payment page only and shouldn’t consume the “Code” value for updating the payment status.

  • For Payment Stauts Confirmation, merchants should rely only on Webhook or Check Status API response.
code=PAYMENT_SUCCESS&merchantId=PGTESTPAYUAT&transactionId=caa0e0c1-250c-4963-8e63-2f74fe7fb446&amount=1000&providerReferenceId=T2306011442566832817587&param1=na&param2=na&param3=na&param4=na&param5=na&param6=na&param7=na&param8=na&param9=na&param10=na&param11=na&param12=na&param13=na&param14=na&param15=na&param16=na&param17=na&param18=na&param19=na&param20=na&checksum=2ec420101ce340d500564d384adb5625accf5354bedcfa4588a9a4d915c2dbd0%23%23%231