---
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', 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

---

[API](https://skmtc.net/increase/apis/increase-api-2.md) · [All operations](https://skmtc.net/increase/apis/increase-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/increase/increase-api-2/versions/e968bcd4dcf9/schema)