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

Provision token and create passkey

This api is used for the below use cases:

1. Create token in VISA’s tokenization system and create a passkey for new enrollment
2. Do device binding for new enrollments
3. Do passkey verification for purchase flows

Request

Response

API Endpoints

Sandbox Link

POST

https://sandbox.juspay.in/provision-token-passkey

Production Link

POST

https://api.juspay.in/provision-token-passkey

                      Basic Auth
                      *
                      

String

Mandatory

Consists of two parts.

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

Example:- Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==

                      x-merchantid
                      *
                      

String

Mandatory

Merchantid of the AI Agent to be passed here

Body

Request Schema: application/json

                      customerId
                      *
                      

String

Mandatory

Customerid used during the transaction

                      sessionContext
                      *
                      

String

Mandatory

This has the session token received from VISA to be passed for passkey craetion

                      browserData
                      *
                      

String

Mandatory

This key contains the browser data which is used by VISA to determine if passkey flow is eligible for the device or not

                      clientReferenceId
                      *
                      

String

Mandatory

This is a session identifier for VISA to track the session over the course of the transaction

                      authFlowType
                      *
                      

ENUM

Mandatory

To identify that this flow is going through the passkey flow

Example value: FIDO

                      presentationType
                      *
                      

ENUM

Mandatory

Type of token that will be generated at VISA tokenization system

Example value: AI_AGENT

                      amount
                      *
                      

JSON

Mandatory

Amount along with currency is passed here

                      currency
                      *
                      

String

Mandatory

Currency of the transaction

                      total
                      *
                      

String

Mandatory

Transaction amount

                      paymentInstrument
                      *
                      

JSON

Mandatory

This contains the temp token that is used by Juspay backend to communicate with VISA

                      type
                      *
                      

ENUM

Mandatory

Type of payment instrument used by Juspay backend

Example: CARD_TOKEN

                      cardObj
                      *
                      

String

Mandatory

Value of the type. It can be a tokenid or Juspay temp token

Example: ctkn_cyq8CfH5yQEPxux8

Response Body

                      errorMessage
                      
                      

                      status
                      *
                      

String

Mandatory

Example value: SUCCESS

                      payload
                      
                      

Object

Conditional

                      stepUpResponse
                      
                      

Object

                      availableStepUpMethod
                      
                      

Array

                      otpInfo
                      
                      

                      deviceBindingStatus
                      
                      

String

Example:- CHALLENGED

                      stepUpMethod
                      
                      

                      vProvisionedTokenId
                      
                      

String

Example: sbdjkvnsdjknvcsd91899

                      errorCode
                      
                      

                      actionToBePerformed
                      
                      

ENUM

Conditional

Tells whether it is a bind or purchase flow

                      authPreferencesEnabled
                      
                      

JSON

Conditional

                      responseType
                      
                      

String

Example:- code

                      responseMode
                      
                      

String

Example:- com_visa_web_message

                      platformType
                      
                      

ENUM

Conditional

Which platform this transaction is being done in

Example: WEB/MOBILE_WEB

Response Body

                      error
                      
                      

Boolean

Example:- true

                      error_message
                      
                      

String

Example:- Access Denied

                      user_message
                      
                      

String

Example:- Access Denied

                      error_info
                      
                      

Object

                      code
                      
                      

String

Example:- UNAUTHORIZED

                      category
                      
                      

String

Example:- USER_ERROR

                      href
                      
                      

String

Example:- NA

                      request_id
                      
                      

String

Example:- 46231085-a366-4279-91af-843a2dfa6e8b

                      user_message
                      
                      

String

Example:- Unauthorized.

                      developer_message
                      
                      

String

Example:- Invalid merchant ID.