• 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 Funding/Disbursal Account List API

      Use Case


      This API is used to fetch the details (balance, guid) of funding account and all disbursal accounts

      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
      subwalletGuid string
      optional
      Sub wallet/disbursal account GUID. This is available on Paytm dashboard

      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 SUCCESS.
      statusMessage string
      Description of each statusCode.
      result Result
      List of funding accounts / disbrusal accounts
      Result +
      AttributeDescription
      walletType string(50)
      This is the type of wallet which can be CORPORATE_VOUCHER or MARKETING_DEALS.
      subWalletGuid string(50)
      Sub wallet/disbursal account GUID. This is available on Paytm dashboard
      walletName string(50)
      This is the name of a wallet/disbursal account name.
      walletBalance string
      Balance of the wallet/disbursal account.
      currencyCode string
      Currency code.
      lastUpdatedDate string
      Last update date when the amount added in a wallet/disbursal account.

      Response Codes and Messages


      statusCodestatusstatusMessage
      DE_001SUCCESSRequest Successfully fullfilled.
      DE_1001FAILUREUnable to process the request, Please check and try again.
      DE_1002FAILUREInvalid merchant.
      DE_1003FAILURESub wallet not found.
      DE_1006FAILUREMerchant is inactive.
      DE_1007FAILUREWallet could not be found, please verify walletGuid.
      DE_1009FAILURESub wallet guid is not associated with this merchant.
      DE_1017FAILUREUnable to fetch subwallet of merchant.
      StagingProduction
      REQUESTRESPONSE
      curl -X POST 'https://staging-dashboard.paytm.com/bpay/api/v1/account/list' \
      --header 'Content-Type: application/json' \
      --header 'x-mid: {mid}' \
      --header 'x-checksum: {checksum}' \
      --data '[]'