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

      Fetch Transaction API

      Checksum required: Yes

      Use Case


      Fetch Transaction API would be used to fetch the transactions against a link.

      Request Attributes

      Head

      ATTRIBUTEDESCRIPTIONMANDATORY
      timestamp longUnix Timestamp of the requestYes
      clientId StringClientId by which key checksum is created, required to validate the checksumNo
      version StringVersion of the API. Current version is v1.No
      channelId StringChannel by which call is initiatedYes
      tokenType AESType of tokenYes
      signature StringChecksum string created by using Paytm checksum logicYes

      Body

      ATTRIBUTEDESCRIPTIONMANDATORY
      mid StringMerchant unique identifier, Unique Id for merchant provided by PaytmYes
      linkId StringUnique Link IdentifierYes
      pageNo intPage NumberNo
      pageSize intPage Size = Total Links/Total no. of PagesNo
      searchStartDate StringFrom DateNo
      searchEndDate StringTo DateNo

      Response Attributes

      Head

      ATTRIBUTEDESCRIPTIONMANDATORY
      timestamp longUnix Timestamp of the requestYes
      clientId StringClientId by which key checksum is created, required to validate the checksumNo
      version StringVersion of the API passed in the request.No
      channelId StringChannel by which call is initiatedYes
      tokenType AESType of tokenYes
      signature StringChecksum string created by using Paytm checksum logicYes

      Body

      ATTRIBUTEDESCRIPTIONMANDATORY
      orders OrdersOrder DetailsYes
      merchantId StringUnique Identifier for MerchantYes
      merchantName StringMerchant NameYes
      resultInfo StringResult information, refer the Result JSON Object tableYes

      Orders

      ATTRIBUTEDESCRIPTIONMANDATORY
      txnId StringPaytm Transaction IdYes
      orderId StringUnique Order IDYes
      mercUniqRef StringLink ID or Invoice IDYes
      orderCreatedTime StringTime of Order CreationYes
      orderCompletedTime StringTime of Order completionYes
      orderStatus StringStatus of the OrderYes
      customerPhoneNumber StringPaytm Registered Number used by customer to make paymentYes
      customerEmail StringPaytm Registered Email used by customer to make paymentNo
      customerName StringPaytm Registered Name used by customer to make payment.No
      txnAmount doubleTransaction AmountYes
      reconId StringUnique Order IDYes

      ResultInfo

      ATTRIBUTEDESCRIPTIONMANDATORY
      resultCode StringResult code for each resultYes
      resultStatus StringStatus of API call
      (S:Success, F:Failure, U:Unknown)
      Yes
      resultMessage StringMessage contain the information about the resultYes

      Endpoints

      Staging: https://securegw-stage.paytm.in/link/fetchTransaction

      Production: https://securegw.paytm.in/link/fetchTransaction

      Request CodeResponse JSON
      curl -X POST 'https://securegw-stage.paytm.in/link/fetchTransaction' --header 'Content-Type: application/json' --data '{"body":{"mid":"{mid}","linkId":"{link-id}"},"head":{"tokenType":"AES","signature":"{signature}"}}'