search

Payment Status

Paytm sends a server to server (S2S) response in key value pairs on the webhook configured and on callback URL. Payment Success Webhook response is sent for the final transaction status i.e. success or failed. To configure the URL, please Get in touch.

The sample response of different payment sources are mentioned below.

Success

[ORDERID] => ORDERID_98765
[MID] => INTEGR7769XXXXXX9383
[TXNID] => 202005081112128XXXXXX68470101509706
[TXNAMOUNT] => 1.00
[PAYMENTMODE] => PPI
[CURRENCY] => INR
[TXNDATE] => 2020-07-24 15:13:02.0
[STATUS] => TXN_SUCCESS
[RESPCODE] => 01
[RESPMSG] => Txn Success
[GATEWAYNAME] => WALLET
[BANKTXNID] => 62909899
[BANKNAME] => WALLET
[CHECKSUMHASH] => y5Tn02QKOQdhyYKK+uHHgNIIZOjC/xPf4jSPQRBNSrcP6DR3ejFuQ4+kQi0a8KX2txJCnQkTnUxtJhM6jImU8FU+E1GlSSK5VjMLsSm/R6w=

Failure

[ORDERID] => ORDERID_98765
[MID] => INTEGR7769XXXXXX9383
[TXNID] => 202005081112128XXXXXX68470101509706
[TXNAMOUNT] => 1.00
[PAYMENTMODE] => PPI
[CURRENCY] => INR
[TXNDATE] => 2020-07-24 15:13:02.0
[STATUS] => TXN_FAILURE
[RESPCODE] => 227
[RESPMSG] => Your payment has been declined by your bank. Please try again or use a different method to complete the payment.
[GATEWAYNAME] => WALLET
[BANKTXNID] => 62909899
[BANKNAME] => WALLET
[CHECKSUMHASH] => y5Tn02QKOQdhyYKK+uHHgNIIZOjC/xPf4jSPQRBNSrcP6DR3ejFuQ4+kQi0a8KX2txJCnQkTnUxtJhM6jImU8FU+E1GlSSK5VjMLsSm/R6w=

Note: All the response codes of the transaction are available here.

The parameters are briefly described below.

Response Attributes

ATTRIBUTE DESCRIPTION
ORDERID OrderId passed in the request
Example:OREDRID_98765
MID Merchant ID passed in the request
Example: INTEGR7769XXXXXX9383
TXNID Unique reference number generated at paytm side for each transaction
Example: 202005081112128XXXXXX68470101509706
TXNAMOUNT Payment transaction Amount
Example: 1.00
CURRENCY Payment currency type
Example:INR
PAYMENTMODE Payment Mode used in payment
Example: PPI
TXNDATE Transaction Date
Example: 7/24/2020 15:13:02
STATUS This parameter indicates the status of API call.
Example: TXN_SUCCESS
RESPCODE This is the resultCode corresponding to a particular message and is returned to the merchant. It's maximum length is 64. For list of different RESPCODE and RESPMSG please refer to the PDF.
Example: 01
RESPMSG This parameter is the result message which contains information about the result.
Example: Txn Success
GATEWAYNAME Gateway Name used in payment
Example: WALLET
BANKTXNID Unique reference number generated at bank side for each transaction
Example: 62909899
BANKNAME Bank Name used in payment
Example: WALLET
CHECKSUMHASH Paytm validates the parameter values by verifying the signature comes in the request. It ensures that parameter values are not tempered. Signature string can be created by using Paytm checksum library.
Example:
y5Tn02QKOQdhyYKK+uHHgNIIZOjC/XXXXjSPQRBNSrcP6DR3ejFuQ4+kQi0a8KX2txJCnQkTnUxtJhM6jImU8FU+E1GlSSK5VjMLsSm/R6w=