post https://api.juspay.in/txns#WalletDirectDebit
Directly debit the amount from a Wallet that is linked to a Customer’s account. If the status in the response is CHARGED
, then the payment is immediatley successful. If the status in the response is PENDING
, then the user wallet doesn’t have sufficient balance for the payment and the topup URL is returned in the response.
Note: This is an authenticated call unlike other transaction APIs. This API must be invoked from your server directly. DO NOT send the API Key to client.
For WALLET transactions, the payment_method attribute must be one from this table: wwww (click to open table)
payment_method | Bank |
---|---|
MOBIKWIK | MobiKwik Wallet |
PAYTM | PayTM |
FREECHARGE | FreeCharge wallet |
OLAMONEY | Ola Money wallet |
The response for the Wallet Direct Debit API is a Payment Status Object (click to open table)
Parameter | Type | Description |
---|---|---|
order_id | String | Unique Identifier for the order. |
txn_id | String | Transaction ID for the payment attempt. |
status | String | Status of the transaction. See Appendix below for status mapping. PENDING_VBV indicates that the transaction requires authentication to complete. |
payment.authentication.method | String | HTTP Method for authentication. Can be one of GET or POST (See redirection instructions in the "Handling the Redirection Method" section.) |
payment.authentication.url | String | URL to which the user has to be taken to for completing the authentication |
payment.authentication.params | Object | Present only when the method is POST. This a mapping via a list of key:value pairs that must be sent along with the URL for authentication. Do not hardcode the params in your client * Never assume that you will receive param “x” or param “y”. This is completely dynamic and will vary on a case by case basis. |
Status | ID | Meaning |
---|---|---|
NEW | 10 | Newly created order |
PENDING_VBV | 23 | Authentication is in progress |
CHARGED | 21 | Successful transaction |
AUTHENTICATION_FAILED | 26 | User did not complete authentication |
AUTHORIZATION_FAILED | 27 | User completed authentication, but bank refused the transaction |
JUSPAY_DECLINED | 22 | User input is not accepted by the underlying PG |
AUTHORIZING | 28 | Transaction status is pending from bank |
⭣
The request consists of Payment Method Details and a direct_wallet_token, which is a Juspay wallet token for linked wallets (see List Wallets API). Parameters are listed below: