The API should be polled using the Exponential Back Off Retry strategy with an initial interval of 2 minutes and the multiplier factor of 2, for subsequent attempts and the cap the maximum gap of retries at 1 day.
Unique Merchant ID assigned to the merchant by PhonePe
Yes
merchantTransactionId
STRING
merchantTransactionId for which status is to be fetched
Yes
Response Parameters
Response Data Description: JSON Level Fields
Field Name
Data Type
Description
success
BOOLEAN
Redundant field. To be ignored by merchants.
code
STRING
See "TRANSACTION STATUS : Response Code" table for a list of possible values and their meanings. Make use of the value of this field for taking decisions related to the status of the transaction.
message
STRING
Short message describing the code
data
OBJECT
Object containing details of actual response data
Response Data Description: Data Level Fields
Field Name
Data Type
Description
merchantTransactionId
STRING
Unique Id generated by merchant sent in pay request
merchantId
STRING
Unique Id assigned to the merchant in the PhonePe system. Assigned during merchant onboarding.
amount
LONG
Amount to be credited to the user. (in paise)
providerReferenceId
STRING
Phonepe transactionId generated for the credit request
paymentState
STRING
Phonepe internal payment state. This is an informative field. Don’t use this field for making decisions, since new values can be added to it.
payResponseCode
STRING
Phonepe payment status code. Please note, this is a string and new values can be added as and when needed. Don’t use this field for making decisions.
paymentModes
List
Object containing payment details.
Language
Click Try It! to start a request and see the response here!
