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

Generate/Refresh Token API

A single endpoint that issues access and refresh tokens, with behaviour set by action. Use code to exchange a merchant's authorization code for the first token pair, and refresh_token to obtain a new pair - no merchant action required.

action - generate_token exchanges the authorization code from the merchant's consent for an access token and refresh token. Call this from your backend immediately after Juspay redirects to your redirect_uri with the code.

action - refresh_token obtains a new access token and refresh token pair using a valid refresh token, without requiring any merchant action. Call this before the access token's expiry to keep the merchant's authorization active.

Request

Response

API Endpoints

Sandbox Link

POST

https://sandbox.portal.juspay.in/ec/v2/token

Production Link

POST

https://portal.juspay.in/ec/v2/token

                      Content-Type
                      
                      

String

Example:- application/json

Body

Request Schema: application/json

                      client_id
                      
                      

String

client ID from create client response

                      client_secret
                      
                      

String

client secret from create client response

                      action
                      
                      

String

generate_token | refresh_token

Example:- generate_token

                      code
                      
                      

String

Conditionally Required

Mandatory if action is passed as generate_token

Received on the redirect_uri post authorization

                      refresh_token
                      
                      

String

Conditionally Required

Mandatory if action is passed as refresh_token

Response Body

                      token_type
                      
                      

String

Example:- Bearer

                      expires_in
                      
                      

String

Example:- 7776000

                      merchant_id
                      
                      

String

Example:- newtestankit11

                      access_token
                      
                      

String

Example:- oauthV2_user_59c3684840840ed8bb3a37864e1b26a867b22b6c056cdf2c6f7b901340e874d3e8d235598e7d34e57c8cba981326fa

                      refresh_token
                      
                      

String

Example:- oauthV2_user_45b172fc52bfa0beb9796e4aad4cefd7019c0d8dad5f6ee1fb092d0155eefcb721115f74839fdd0db535d6b2615d78cbdf883fdf0b82024e715dcc0151932ab6