---
page_title: Get Security Code
product: Jusbiz - Payouts
page_source: https://juspay.io/in/docs/jusbiz/docs/integration/get-security-code
openapi: https://juspay.io/in/docs/api/swagger?document=https%3A%2F%2Fjuspay.io%2Fin%2Fdocs%2Fjusbiz%2Fdocs%2Fintegration%2Fget-security-code
llms_txt: https://juspay.io/in/docs/llms.txt
product_llms_txt: https://juspay.io/in/docs/jusbiz/llms.txt
---

## API Version: default


# Get Security Code



The purpose of this API is to allow the fetching of cvv## Endpoints:
- Sandbox: https://sandbox.biz.juspay.in/ardra/vt/cvv/v2

- Production: https://{{hostname}}.biz.juspay.in/ardra/vt/cvv/v2

## Request Type: 
POST

## Authorization:

#### Basic Auth:
Consists of two parts.

* Username: API Key obtained from Juspay dashboard
* Password: Empty string
- Value:  Basic MUQ2QUxxxxxxxxxxxxU5QTIxQzNFNTQwNkFDMEZCOg==
- Tags: String, Mandatory
## Headers:

#### X-merchantid:
Pass merchant-id provided by Juspay
- Tags: string, Mandatory

#### KeyId:
Key Id against which encryption is done (to be taken from JusBiz Dashboard)
- Tags: String, Mandatory

#### Content-Type:
- Value:  application/json
- Tags: String, Mandatory
## Sample Code Snippets:
### Sample Request:

#### Request Code Snippet:

```request
curl --location 'https://sandbox.biz.juspay.in/ardra/vt/cvv/v2' \
--header 'KeyId: <key Id>>' \
--header 'Content-Type: application/json' \
--header 'X-merchantid: <merchant id>' \
--header 'Authorization: Basic (b64 encoded API key)' \
--data '{
    
    "payoutId": "Juspay123456789",
    "isCardImageRequired": true
}'
```

### Sample Response:

#### Response:
```json
{
    "status": "SUCCESS",
    "response": {
        "cardImage": "{base64-encoded-cardImage}",
        "securityCode": "119"
    },
    "message": "Security Code Fetched Successfully",
    "payoutId": "Juspay123456789"
}
```

## Body Parameters:
### Section1:

#### payoutId:
- Description: A unique value required to fetch the cvv for a particular token
- Value: value
- Tags: String, Mandatory

#### isCardImageRequired:
- Description: To get card image pass value as true
- Tags: Optional, Boolean
## API Responses:
### 200:

#### 200: Response Body:
- Tags: Object

#### status:
- Description: Status of the API callPossible value: SUCCESS | FAILURE
- Tags: String

#### payoutId:
- Description: Unique value of payout id which was sent in the request.
- Tags: String

#### message:
- Description: Reason for failure / success.
- Tags: String

#### response:
- Description: The response contains the details around the token which will be used for processing payments
- Value:
  - **SecurityCode**:
    - Description: Security Code for the token
    - Tags: String
  - **CardImage**:
    - Description: Base 64 encoded string will be sent
    - Tags: String
- Tags: Object
### 400:

#### status:
- Description: SUCCESS | FAILURE
- Tags: String

#### payoutId:
- Description: Unique value of payout id which was sent in the request. E.g. “Juspay123456789”
- Tags: String

#### message:
- Description: Reason for the Parameter which is invalid
- Tags: String
### 401:

#### message:
- Description: 1. Invalid Key ID passed
2. Basic Auth & Key ID missing in Headers
3. Key ID missing in Headers
4. Basic Auth missing in Headers
5. Unauthorised: No key given
- Tags: String, Mandatory
### 500:

#### message:
- Description: Error Message: Validated Expense Data cannot be Empty
- Tags: String


---

## See Also

- [Token Status Check](https://juspay.io/in/docs/jusbiz/docs/integration/token-status-check)
- [Delete Virtual Card](https://juspay.io/in/docs/jusbiz/docs/integration/delete-virtual-card)