Check Transaction Status

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.

Request Headers

Header Name

Header Value

Content-Type

application/json

X-VERIFY

SHA256("/v3/transaction/{merchantId}/{merchantTransactionId}/status" +
saltKey) + "###" + saltIndex

Path Parameters

Parameter Name

Type

Description

Mandatory

merchantId

STRING

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!