> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-60c89f9a-mintlify-audit-missing-sections-1778528421.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Bind the Device

> **POST** `/v1/upi/tpap/devices/bind`

Use this endpoint to bind the device.

### Request

```curl: Request theme={null}
curl -X POST 'api.rzp..com/v1/upi/tpap/devices/bind' \
-u [YOUR_KEY_ID]:[YOUR_SECRET] \
-H "Content-type: application/json" \
-H "x-customer-reference: customer-id-from-customer" \
-d '{
  "mobile":"91999999999",
  "verification_type":"sms",
  "sms":{
    "content":"UPIACT ad56ef90396348bac56099"
  },
  "uuid":"",
  "app":"test.merchant.upi.com",
  "ssid":"123456789",
  "manufacturer":"samsung",
  "model":"Galaxy S23",
  "os":"android",
  "os_version":"Dev12345"
}'
```

### Response

```json: Response theme={null}
{
  "entity":"upi.device",
  "mobile":"999999999",
  "uuid":"",
  "app":"test.merchant.upi.com",
  "ssid":"123456789",
  "manufacturer":"samsung",
  "model":"Galaxy S23",
  "os":"android",
  "os_version":"Dev12345",
  "status":"verified"
}
```

### Parameters

`mobile` *mandatory*
: `string` Mobile number of the customer.

`verification_type` *mandatory*
: `string` The verification type. Possible value is `sms`.

`sms` *mandatory*
: `object` The device details.

`content`
: `string` SMS content to be used for device binding of this token as returned by the [Get Verification Token API](/api/payments/tpap-pro/customer-onboarding/verification-token).

`device` *mandatory*
: `object` The device information. This should be the same information sent when you [get the verification token api](/api/payments/tpap-pro/customer-onboarding/verification-token).

`uuid`
: `string` The unique identifier of the device. For example, `advertising_id` or `android_id`.

`app`
: `string` The package name for the app.

`ssid`
: `string` The service set identifier (unique network identifier).

`manufacturer`
: `string` The phone manufacturer.

`model`
: `string` The phone model. For example, `Galaxy S23`.

`os`
: `string` The operating system running on the device.

`os_version`
: `string` The version of the operating system.

### Parameters

`entity`
: `string` Indicates the type of entity. Here it is, `device`.

`mobile`
: `string` The mobile number of the customer.

`uuid`
: `string` The unique identifier of the device. For example, `advertising_id` or `android_id`.

`app`
: `string` The package name for the app.

`ssid`
: `string` The service set identifier (unique network identifier).

`manufacturer`
: `string` The phone manufacturer.

`model`
: `string` The phone model. For example, `Galaxy S23`.

`os`
: `string` The operating system running on the device.

`os_version`
: `string` The version of the operating system.

`status`
: `string` Device binding status. Know more about the [device binding status](/payments/tpap-pro/integration-guide#device-binding-status).