• Getting Started
    • Mobile Integration (Android/IOS)
      Enterprise Solutions
      Accept Payments
      Process Payments
      Disbursals
      API References
      Webhooks
      Testing
      Refunds
      Guides
      Other Processes
      Mini Program Platform
        Website Integration

      Accept Refund

      Checksum required: Yes

      Use Case


      The webhook is generated after successful deduction of refund amount from merchant’s due settlement amount. After completion of this step, we have accepted the refund

      Definitions:

      Head

      ATTRIBUTEDESCRIPTIONMANDATORY
      signature StringChecksumYES

      Body

      ATTRIBUTEDESCRIPTION
      txnId String (64)This is a unique Paytm transaction ID corresponding to REFID for which status is being checked. TXNID is provided in response payload for every transaction
      orderId String (50)Order ID is merchant’s unique reference ID for a transaction passed in the transaction payload
      txnAmount String (10)Order value of the transaction in INR
      txnTimestamp String (30)Timestamp of payment transaction
      refundAmount String (10)Total cumulative refund amount against this transaction. For example for a transaction with order value as INR 100, there has been two refunds of INR 20 & INR 30 historically, then TOTALREFUNDAMT will be INR 50
      acceptRefundTimestamp String (30)Timestamp at which Paytm accepted the refund. At the time of acceptance refund amount is deducted from the merchant payable balance
      refId String (50)Merchant’s reference ID unique for every refund transaction. This is REFID for which refund status is being inquired
      merchantRefundRequestTimestamp String (30)Timestamp at which merchant requested the refund
      refundId String (64)This is a unique Paytm refund identifier that is issued by Paytm for each valid refund request
      {
                      "head": {
                          "signature": "f1gHpa2fdTS57X6jniuIxlinBU/u9LO93q2BS4DgdbK97XUq8AseintKhqfBP3wUTKH7o+="
                      },
                  "body": {
                  "txnId":"20190407111212800110168026100689591",
                  "orderId":"PARCEL278824",
                  "txnAmount":"25.00",
                  "refundAmount":"1.15",
                  "txnTimestamp":"2019-04-07 15:03:32.0",
                  "acceptRefundTimestamp":"2019-04-22 23:24:40.0",
                  "refId":"REF1090",
                  "merchantRefundRequestTimestamp":"2019-04-22 23:24 :33.0",
                  "refundId":"20190422111212801300168880700034251"
                  }
                  
                  }