JavaScript is disabled. Some features may not work. You can also read the static version: View text version

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://sandbox.juspay.in/wallets/{wallet_id}

Production Link

POST

https://api.juspay.in/wallets/{wallet_id}

                      Basic Auth 
                      *
                      

Base64 Encoded Username:Password

Mandatory

Consists of two parts.

Username: API Key obtained from Juspay dashboard
Password: Empty string

Example:-
Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==

                      Content-Type
                      *
                      

String

Mandatory

application/x-www-form-urlencoded

                      x-routing-id
                      *
                      

String

Required

We recommend passing the customer_id as the x-routing-id. If the customer is checking out as a guest, you can pass an alternative ID that helps track the payment session lifecycle. For example, this could be an Order ID or Cart ID.

This ID is associated with the customer. It plays a key role in ensuring consistency and maintaining connections across different systems. If you fail to pass the same x-routing-id for the same customer in all related API calls, it could lead to issues with API functionality. Therefore, it’s crucial that you use the same x-routing-id for all requests tied to the same customer.

Example:- customer_1122

                      wallet_id
                      *
                      

String

Mandatory

Wallet Id of the wallet

Body

                      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.

Response Body

id

string

wlt_q23xzki3pazgtezo

                      object
                      
                      

string

wallet_account

                      wallet
                      
                      

string

MOBIKWIK

                      token
                      
                      

string

tok_winysteev9eftrwcv6me

                      current_balance
                      
                      

integer

                      linked
                      
                      

boolean

                      last_refreshed
                      
                      

string

2016-08-01T08:07:52+0000

Response Body

                      object
                      
                      

object

{}