POSTAdd Funds in disbursal account/subwallet API
Use Case
This API is used to add funds in disbursal account/subwallet from the main funding account.
HTTP Headers
| ATTRIBUTE | DESCRIPTION |
|---|---|
|
x-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. |
|
x-checksum string(108) |
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 |
Sub wallet/disbursal account GUID. This is available on Paytm dashboard |
|
amount string |
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
| statusCode | status | statusMessage |
|---|---|---|
| DE_001 | SUCCESS | Request Successfully fullfilled. |
| DE_1001 | FAILURE | Unable to process the request, Please check and try again. |
| DE_1002 | FAILURE | Invalid merchant |
| DE_1003 | FAILURE | Sub wallet not found. |
| DE_1004 | FAILURE | Wallet balance is insufficient for this transaction. Please add money in your wallet and retry. |
| DE_1005 | FAILURE | Invalid currency code. |
| DE_1006 | FAILURE | Merchant is inactive. |
| DE_1007 | FAILURE | Wallet could not be found, please verify walletGuid. |
| DE_1008 | FAILURE | Payee wallet could not be found. |
| DE_1009 | FAILURE | Sub wallet guid is not associated with this merchant. |
| DE_1010 | FAILURE | Merchant can't transfer money to his own wallet. |
| DE_1011 | FAILURE | Merchant can't transfer money which is not added in Business wallet manually. |
| DE_1012 | FAILURE | Fund transfer not allowed to top up wallet. |
| DE_1013 | FAILURE | Fund transfer not allowed from top up wallet. |
| DE_1014 | FAILURE | Max per transaction amount exceed. |
| DE_1015 | FAILURE | Maximum number of allowed transactions exceed. |
| DE_1016 | FAILURE | Invalid Transaction Amount. |
| DE_1017 | FAILURE | Unable to fetch subwallet of merchant. |
| DE_199 | FAILURE | Process Failed |
Staging
Production
https://staging-dashboard.paytm.com/bpay/api/v1/account/credit
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"}'
