---
title: "Sandbox: Create a digital wallet token request"
method: POST
path: "/simulations/digital_wallet_token_requests"
---

# Sandbox: Create a digital wallet token request

`POST /simulations/digital_wallet_token_requests`

Simulates a user attempting to add a [Card](#cards) to a digital wallet such as Apple Pay.

## Request body

- SandboxCreateADigitalWalletTokenRequestParameters
  - `card_id` string, required — The identifier of the Card to be authorized.

## Response `200`

Inbound Digital Wallet Token Request Simulation Result

- InboundDigitalWalletTokenRequestSimulationResult — The results of a Digital Wallet Token simulation.
  - `decline_reason` 'card_not_active' | 'no_verification_method' | 'webhook_timed_out' | 'webhook_declined' | 'incorrect_card_verification_code' | 'declined_by_token_requestor' | 'group_locked' | 'account_closed' | 'entity_not_active', nullable, required — If the simulated tokenization attempt was declined, this field contains details as to why.
  - `digital_wallet_token_id` string, nullable, required — If the simulated tokenization attempt was accepted, this field contains the id of the Digital Wallet Token that was created.
  - `type` 'inbound_digital_wallet_token_request_simulation_result', required — A constant representing the object's type. For this resource it will always be `inbound_digital_wallet_token_request_simulation_result`.

## Other responses

- `4XX` — Error
- `5XX` — Error

## Changes

- **2026-09-23** `1531a32c1d6e` — 3 warning
  - added the new `account_closed` enum value to the `decline_reason/anyOf[subschema #1]/` response property for the response status `200`
  - added the new `entity_not_active` enum value to the `decline_reason/anyOf[subschema #1]/` response property for the response status `200`
  - added the new `group_locked` enum value to the `decline_reason/anyOf[subschema #1]/` response property for the response status `200`

[Change history](https://skmtc.dev/increase/apis/increase-api-2/changes/simulations/digital_wallet_token_requests/post.md)

---

[API](https://skmtc.dev/increase/apis/increase-api-2.md) · [All operations](https://skmtc.dev/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/increase/apis/increase-api-2/revisions/ff98a6043c63?raw)