search

POSTAdd 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-mid

string(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-checksum

string(108)
mandatory

Signature encryption for validation. It's value to be sent should be the checksum string created by using Paytm checksum library.
Note: Create the signature using all the request parameters.

Request Attributes

API Content Type: JSON

ATTRIBUTE DESCRIPTION

subwalletGuid

string
mandatory

Sub wallet/disbursal account GUID. This is available on Paytm dashboard

amount

string
mandatory

Amount in INR to be claimed back from disbursal account

Response Attributes

API Content Type: JSON

ATTRIBUTE DESCRIPTION

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.

Response Codes & 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.
Staging
Production
https://staging-dashboard.paytm.com/bpay/api/v1/account/creditcopy icon
REQUEST
RESPONSE
CURL
JAVA
NODE
PHP
PYTHON
DOTNET
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"}'
copy icon