# Simulate device binding

**POST** `/simulate/issuing/cards/tokens/{card_token_id}/device-binding`

Simulate a Visa device binding for a card token on a `visa_sandbox` card. Column records the binding and its decision
on the token and returns the updated card token.

Set `decision_override` to `approve`, `decline`, or `step_up` to force the outcome without calling your endpoint. When
it is omitted, the binding flows through Column's real decisioning.

### Path Parameters

- `card_token_id` `string` _(required)_ — Unique identifier for the card token.

### Body Parameters

- `decision_override` `string` — Forces the device binding outcome, bypassing the card-status-based decision and the
  customer decision webhook. One of `approve`, `decline`, or `step_up`. When omitted, the
  binding flows through the real decisioning path.
- `device_id` `string` — Identifier of the device being bound.
- `device_name` `string` — A human-readable identifier for the device being bound.
- `device_type` `enum` — The category of device being bound.
  Possible values: `mobile_phone`, `tablet`, `watch`
- `wallet_account_id` `string` — The wallet account identifier associated with the device binding.

**Request**

```shell
curl 'https://api.column.com/simulate/issuing/cards/tokens/<card_token_id>/device-binding' \
  -XPOST \
  -u :<YOUR API KEY> \
  -H 'Content-Type: application/json' \
  -d '{
  "device_id": "<device_id>",
  "wallet_account_id": "<wallet_account_id>",
  "decision_override": "example_decision_override",
  "device_name": "Example device name",
  "device_type": "mobile_phone"
}'
```

**Response 200**

```json
{
  "card_account_id": "cacc_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_id": "card_2x8gszy5folpA9s0TOCseE9ABDM",
  "card_program_id": "cpgm_2x8gszy5folpA9s0TOCseE9ABDM",
  "created_at": "2024-01-15T09:30:00Z",
  "device_name": "iPhone",
  "device_type": "mobile_phone",
  "id": "ctkn_2x8gszy5folpA9s0TOCseE9ABDM",
  "network_token_reference_id": "DNITHE302312345678901234",
  "status": "active",
  "wallet_type": "apple_pay"
}
```