post https://api.juspay.in/wallets/#linkwallet
Completes the authentication and linking process of the wallet with the customer account. OTP received from the authenticate
API call is forwarded to Juspay using this API for linking the wallet. On successful verification of the OTP, the wallet is linked with the customer object. If failed, the linked
attribute will remain to be false
. Returns the wallet object. Also generates one-time use token for direct debit transactions.
Returns: Wallet Object (click to view)
Provides details of a selected wallet of a customer:
Parameter | Type | Description |
---|---|---|
id | String | The unique identifier generated by Juspay for a particular wallet |
object | String | Must be "wallet_account" |
wallet | String | Name of the Wallet Provider |
token | String | One time token used to initiate a wallet transaction (expires after 15 minutes) |
current_balance | String | The balance available in the wallet as of the last refresh update. Available only for linked wallets. |
linked | boolean | If true, wallet is linked with the respective customer account. Merchant can then use the given token to debit directly from the wallet. |
last_refreshed | String | Represents the date & time when the balance was updated last. |
metadata:wwwwwww {param1, param2,...} | Object | Custom key-value sets can be passed here. Example: {"mobile_number": "9999999999"} |
gateway_reference_id | String | Unique string identifier for the gateway supplying the wallet. Required in case of multiple MID setup |
NOTE: For linked wallets, the balance in the response may not be the current balance. The last_refreshed field represents the date & time when the balance was updated last. Use Refresh wallet API to update the balance for individual wallets. This results in a network call to the wallet provider and hence the response might be slow.