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

      post Add Funds in disbursal account/subwallet API

      Use Case


      This API is used to add funds in disbursal account/subwallet from main funding account

      HTTP Headers

      ATTRIBUTE DESCRIPTION
      x-midstring(50)
      mandatory
      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.
      x-checksumstring(108)
      mandatory
      Signature encryption for validation. It's value to be sent should be the checksum string created by using Paytm checksum library.

      Request Attributes


      API Content Type: JSON

      ATTRIBUTE DESCRIPTION
      subwalletGuidstring
      mandatory
      Sub wallet/disbursal account GUID. This is available on Paytm dashboard
      amountstring
      mandatory
      Amount in INR to be claimed back from disbursal account

      Response Attributes


      API Content Type: JSON

      ATTRIBUTE DESCRIPTION
      statusCodestring Failure reason code where status is FAILURE. A detailed list of statusCode is mentioned at the bottom of this page.
      statusstring Disbursal request status. It can be FAILURE or ACCEPTED or SUCCESS.
      statusMessagestring Description of each statusCode.

      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_1004FAILUREWallet balance is insufficient for this transaction. Please add money in your wallet and retry.
      DE_1005FAILUREInvalid currency code.
      DE_1006FAILUREMerchant is inactive.
      DE_1007FAILUREWallet could not be found, please verify walletGuid.
      DE_1008FAILUREPayee wallet could not be found.
      DE_1009FAILURESub wallet guid is not associated with this merchant.
      DE_1010FAILUREMerchant can't transfer money to his own wallet.
      DE_1011FAILUREMerchant can't transfer money which is not added in Business wallet manually.
      DE_1012FAILUREFund transfer not allowed to top up wallet.
      DE_1013FAILUREFund transfer not allowed from top up wallet.
      DE_1014FAILUREMax per transaction amount exceed.
      DE_1015FAILUREMaximum number of allowed transactions exceed.
      DE_1016FAILUREInvalid Transaction Amount.
      DE_1017FAILUREUnable to fetch subwallet of merchant.
      StagingProduction
      REQUESTRESPONSE
      curl -X POST 'https://staging-dashboard.paytm.com/bpay/api/v1/account/credit' \
      --header 'Content-Type: application/json' \
      --header 'x-mid: {mid}' \
      --header 'x-checksum: {checksum}' \
      --data '{"subwalletGuid":"28054249-XXXX-XXXX-af8f-fa163e429e83","amount":"1.00"}'