---
title: "Fetch AltID"
method: POST
path: "/payments/ve1_2/altid/get"
tags: ["Guest Checkout (AltID)"]
---

# Fetch AltID

`POST /payments/ve1_2/altid/get`

## Request

- Base URL: `https://uat1.billdesk.com/u2`
- URL: `https://uat1.billdesk.com/u2/payments/ve1_2/altid/get`
- Auth: none declared. Required headers: `BD-Traceid`, `BD-Timestamp`, `Content-Type`, `Accept`

This API is used to retrieve the AltID value from network

## Headers

- `BD-Traceid` string, required
- `BD-Timestamp` string, required
- `Content-Type` string, required
- `Accept` string, required

## Request body

- object
  - `mercid` string, required: Unique identifier as defined by BillDesk for each merchant
  - `orderid` string, required: Unique ID generated by the merchant for each request
  - `amount` string, required: Transaction amount in two decimals, eg. 299.28
  - `currency` string, required: ISO currency of the transaction amount, for INR this value will be 356
  - `device` object, required
    - `ip` string, required: Customer’s IP address
    - `init_channel` 'internet' | 'app' | 'kiosk', required: Initiating channel,accepted values are internet,app or kiosk
    - `user_agent` string: Exact content of the HTTP user-agent header\n\nNote: If the total length of the User-Agent sent by the browser exceeds 2048 characters, truncate the excess portion
  - `card` AltidCardRequest
    - `number` string, required: Card number
    - `expiry_month ` string, required: Card expiry month in MM format
    - `expiry_year` string, required: Card expiry year in YYYY format
    - `cvv` string: Card cvv value
    - `holder_name` string: Cardholder name
  - `rupay_auth_ref_no` string: Refers to the specific transaction reference provided by NPCI (for R cards)

## Response `200`

OK

- object
  - `objectid` 'transaction' | 'authentication' | 'mandate' | 'invoice' | 'cardaccount' | 'validatevpa' | 'dispute' | 'settlement' | 'altid' | 'mandate_token' | 'accountvalidation' | 'refund': String representing the object's type. Objects of the same type share the same value.
  - `mercid` string: Unique identifier as defined by BillDesk for each merchant
  - `orderid` string: Unique ID generated by the merchant for each request
  - `masked_value` string: Masked card number, with the last four digits
  - `altid_value` string: The unique alt id for the Card Number provided in the request.
  - `altid_cryptogram` string: Alt id cyptogram
  - `altid_expiry_month` string: alt id expiry month
  - `altid_expiry_year` string: alt id expiry year
  - `request_date` string: Request initiation timestamp in YYYY-MM-DDThh:mm:ssTZD format

## Other responses

- `403`: Forbidden
- `500`: Internal Server Error
- `default`: Any bad or invalid request will lead to following error object

---

[API](https://skmtc.dev/billdesk/apis/tokenization.md) - [All operations](https://skmtc.dev/billdesk/apis/tokenization/llms.txt) - [OpenAPI document](https://skmtc.dev/billdesk/apis/tokenization/revisions/257528d9c8e1?raw)