• 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

      post Disburse Status​ Query​ ​API

      Use Case


      To check the wallet or bank account disbursal transaction status.

      HTTP Headers

      ATTRIBUTE DESCRIPTION MANDATORY
      x-midstring(50) Paytm provides MID as a unique identifier to each merchant. For your staging MID, click here. You get the production MID post the account activation. mandatory
      x-checksumstring(108) Signature encryption for validation. It's value to be sent should be the checksum string created by using Paytm checksum library. mandatory

      Request Attributes


      API Content Type: JSON

      Body1

      Body

      ATTRIBUTEDESCRIPTION
      orderId string(50)
      mandatory
      Unique reference ID provided by merchant for each disbursal/transfer request.

      Response Attributes


      API Content Type: JSON

      Body2

      Body

      ATTRIBUTEDESCRIPTION
      statusCode string
      Failure reason code where status is FAILURE. A detailed list of statusCode is mentioned at the bottom of this page.
      status string
      Disbursal request status. It can be FAILURE or ACCEPTED or SUCCESS.
      statusMessage string
      Description of each statusCode.
      result Result
      Result details for the transfer APIs.
      Result +
      AttributeDescription
      mid string(50)
      Paytm provides MID as a unique identifier to each merchant. For your staging MID, click here. You get the production MID post the account activation.
      orderId string(50)
      Unique reference id provided by the merchant for this disbursal request.
      paytmOrderId string(50)
      Unique ID generated at paytm end corresponding to each transaction.
      amount string
      Amount in INR requested by the merchant for disbursal.
      commissionAmount string
      Commission amount in INR payable by the merchant. This will contain digits up to two decimal points.
      tax string
      Tax amount in INR payable by the merchant.This will contain digits up to two decimal points.
      rrn string(10)
      Unique reference number created by a bank against each transaction.It is null for wallet transfers.

      Response Codes and Messages


      statusCodestatusstatusMessage
      DE_010FAILUREparameter is mandatory and it's can't be null or blank.
      DE_001SUCCESSSuccessful disbursal to Bank Account is done.
      DE_101PENDINGYour request is in process. Kindly check after sometime.
      DE_102PENDINGDisbursal to Bank Account failed. Your refund to sub-wallet is in process.
      DE_602FAILUREDisbursal to bank account failed. Please try after some time.
      DE_400FAILUREInvalid Request Parameter.
      DE_401FAILUREAuthentication Parameters Required.
      DE_402FAILUREAccess Denied.
      DE_403FAILUREAPI Not Found.
      DE_404FAILUREUnable to authenticate request.
      DE_405FAILURERemote IP not whitelisted.
      DE_408FAILUREChecksum Required.
      DE_409FAILUREChecksum Verification Failed.
      DE_500FAILURESystem Error.
      DE_606FAILUREInvalid account number.
      DE_607FAILUREError at bank end.
      DE_603FAILUREDisbursal to bank account failed.
      DE_609FAILUREUnable to fetch details.
      DE_612FAILUREAccount blocked/frozen.
      DE_613FAILUREInvalid IFSC/MICR.
      DE_614FAILUREAccount is closed.
      DE_615FAILUREInvalid account number or IFSC code.
      DE_616FAILUREDaily allowed amount limit for the beneficiary is exceeded.
      DE_617FAILUREBeneficiary account is NRE account.
      DE_618FAILUREInvalid NBIN (IFSC code).
      DE_619FAILURENPCI rejects as net debit cap is exceeded for remitter.
      DE_620FAILURECard is restricted at beneficiary account.
      DE_621FAILURETransaction declined, Bank not enabled for P2A functionality.
      DE_622FAILUREMaximum limit amount exceeded.
      DE_623FAILUREExceeded maximum allowed number of transfers per day .
      DE_625FAILUREInvalid IFSC code.
      DE_626FAILURETransaction is declined based on From account type and To account type.
      DE_627FAILURETransaction is declined based on transaction limit imposed on the From account type and To account type.
      DE_628FAILUREBeneficiary PPI is Gift prepaid and this is not the first transaction.
      DE_629FAILUREAcquiring bank has not implemented customer initiated person-to-merchant transaction.
      DE_631FAILUREAmount is greater than 2 Lakhs (Applicable for Bank where NDC is greater than 2 Lakhs).
      DE_632FAILUREInvalid payment reference.
      DE_634FAILUREInvalid transaction.
      DE_636FAILUREUnable to process.
      DE_640FAILURELimit Exceed.
      DE_641FAILURENo record found.
      DE_643FAILURERemmiter and beneficiary accounts are same.
      DE_646FAILUREFund transfer not allowed for this transaction type.
      DE_647FAILURERefund not allowed for this transaction type.
      DE_648FAILUREProduct Service Unavailable.
      DE_649FAILURECA Form 60 Val Current Account Form 60 current balance limit breached.
      DE_650FAILURECA Form 60 Val Current Account Form 60 Daily deposit limit breached.
      DE_651FAILUREFraud verification Maquette suspicious response.
      DE_652FAILURENodal IMPS Nodal IMPS Amount Limit Breached.
      DE_653FAILURENodal IMPS Beneficiary Does Not exist.
      DE_656FAILURECredit account freeze.
      DE_701FAILUREMerchant does not exists.
      DE_703FAILUREWallet could not found, please verify walletGuid.
      DE_704FAILURESub wallet not found.
      DE_705FAILUREAgent wallet balance cann't be negative. Please fund your wallet and try again.
      DE_039FAILURENo record found.
      DE_103FAILUREInvalid Response Code.
      DE_105FAILUREBeneficiary name not matched.
      DE_106FAILUREMobile number is not registered.
      DE_107FAILUREKYC is Not Done.
      DE_108FAILUREUnable to validate Beneficiary Name.
      DE_500FAILURESystem Error.
      DE_940FAILUREInvalid Txn Id.
      DE_901FAILUREDisbursal to wallet failed. Please try after sometime.
      DE_902FAILUREDisbursal to wallet failed.
      DE_961FAILUREInvalid user id.
      DE_919FAILUREInvalid merchant.
      DE_963FAILUREUser exist but no corresponding wallet found.
      DE_964FAILUREMerchant exist but no corresponding wallet found.
      DE_906FAILUREPaytm wallet does not exist.
      DE_965FAILUREFound multiple accounts with same phone no. and all are unverified.
      DE_966FAILUREFound multiple accounts with same mail-id and all are unverified.
      DE_967FAILUREMerchant is incative.
      DE_921FAILUREMerchant does not exist.
      DE_922FAILUREInsufficient funds in corporate sub wallet.
      DE_931FAILUREMaximum allowed wallet balance is exceed.
      DE_948FAILUREReceiver has not completed his KYC.
      DE_932FAILUREExceed maximum allowed money addition in wallet for this month.
      DE_933FAILURERBI approved min KYC wallet spending limits exceeded. No new fund additions are allowed.
      DE_926FAILUREMaximum number of allowed transactions exceed.
      DE_947FAILURERBI approved KYC wallet limits exceeded. No new fund additions are allowed.
      DE_924FAILUREMaximum allowed transaction amount exceed.
      DE_925FAILUREMax per transaction amount exceed.
      DE_969FAILURESales wallet not found.
      DE_907FAILUREMerchant can't transfer money to his own wallet.
      DE_970FAILUREInvalid salesWalletGuid.
      DE_971FAILUREInvalid salesWalletName/salesWalletGuid.
      DE_909FAILUREPayee mobile not verified.
      DE_910FAILUREPayee email not verified.
      DE_911FAILUREPayee mobile and email not verified.
      DE_972FAILUREPayer wallet could not found.
      DE_973FAILUREAdding funds to wallet not supported.
      DE_913FAILURESub Wallet not assigned to merchant.
      DE_974FAILURECashback Audit Details not available.
      DE_923FAILUREPaytm Wallet is not active.
      DE_975FAILUREPayer Wallet not active.
      DE_921FAILUREMerchant does not exist.
      DE_905FAILURECorporate wallet not found.
      DE_908FAILUREInvalid userId, email or phone no.
      DE_912FAILUREAdding funds to subwallet not supported.
      DE_914FAILUREFund cannot be refilled in this wallet.
      DE_915FAILUREFunds cannot be added as user wallet type is basic.
      DE_916FAILURESubWallet is not active.
      DE_917FAILUREInvalid Subwallet Expiry Date, Past expiry date is not allowed.
      DE_927FAILUREMaximum allowed transactions amount in a year exceed.
      DE_928FAILUREMaximum number of allowed transactions in a year exceed.
      DE_929FAILURECumulative txn type limit breached.
      DE_934FAILUREThe destination Paytm user will need to do KYC to add/receive money.
      DE_935FAILURESub_Wallet limit exceeded.
      DE_936FAILUREMax Allowed sub wallet limit exceeded.
      DE_937FAILUREMaximum per transaction amount exceed.
      DE_941FAILURERisk Reject.
      DE_943FAILUREMonthly limit for number of Payment to Merchant transactions will exceed.
      DE_944FAILUREDaily limit for total amount of Payment to Merchant transactions will exceed.
      DE_945FAILUREMonthly limit for total amount of Payment to Merchant transactions will exceed.
      DE_946FAILUREDaily limit for number of Payment to Merchant transactions will exceed.
      DE_949FAILUREMonthly credit limit breach.
      StagingProduction
      REQUESTRESPONSE
      curl -X POST 'https://staging-dashboard.paytm.com/bpay/api/v1/disburse/order/query' \
      --header 'Content-Type: application/json' \
      --header 'x-mid: {mid}' \
      --header 'x-checksum: {checksum}' \
      --data '{"orderId":"ORDERID_98765"}'