Body
Link Wallet
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, then linked attribute will remain to be false.
Returns the wallet object.
Request
Response
API Endpoints
Sandbox Link
POST
https://api.sandbox.juspay.io/wallets/{wallet_id}
Production Link
POST
https://api.juspay.io/wallets/{wallet_id}
Authorization Header
Basic Auth
*
Base64 Encoded Username:Password
Mandatory
Consists of two parts.
Username: API Key obtained from Juspay dashboard
Password: Empty string
Example:-
Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==
Parameters
command
*
string
Required
Send it as link if you want to complete the authentication/linking process.
otp
string
OTP sent by the provider to the customer’s registered mobile number.
200 : Success
Response Body
id
*
string
Required
Unique identifier for the wallet account
Example :wlt_q23xzki3pazgtezo
object
*
string
Required
wallet_account
wallet
*
string
Required
Payment gateway provider (e.g., PAYTM, AMAZONPAY)
token
string
Authentication token for the linked wallet (null if unlinked)
Example :tok_winysteev9eftrwcv6me
current_balance
integer
Current available balance in the wallet (null if unlinked or unavailable)
linked
*
boolean
Required
Boolean indicating if the wallet is successfully linked to the gateway
last_refreshed
string
Timestamp of when the wallet balance was last refreshed (null if never refreshed)
Example: 2016-08-01T08:07:52+0000
metadata
Object
Additional wallet-specific data including mobile number and device ID (may be null)
gateway_reference_id
String
Reference ID provided by the payment gateway (may be null)
400 : Invalid Input data
Response Body
status
String
error_code
String
error_info
object