---
title: "Sandbox: Create a Card Token"
method: POST
path: "/simulations/card_tokens"
---

# Sandbox: Create a Card Token

`POST /simulations/card_tokens`

Simulates tokenizing a card in the sandbox environment.

## Request body

- SandboxCreateACardTokenParameters
  - `capabilities` object[] — The capabilities of the outbound card token.
    - `cross_border_push_transfers` 'supported' | 'not_supported', required — The cross-border push transfers capability.
    - `domestic_push_transfers` 'supported' | 'not_supported', required — The domestic push transfers capability.
    - `route` 'visa' | 'mastercard' | 'pulse', required — The route of the capability.
  - `expiration` string, date — The expiration date of the card.
  - `last4` string — The last 4 digits of the card number.
  - `outcome` object — The outcome to simulate for card push transfers using this token.
    - `decline` object — If the result is declined, the details of the decline.
      - `reason` 'do_not_honor' | 'activity_count_limit_exceeded' | 'refer_to_card_issuer' | 'refer_to_card_issuer_special_condition' | 'invalid_merchant' | 'pick_up_card' | 'error' | 'pick_up_card_special' | 'invalid_transaction' | 'invalid_amount' | 'invalid_account_number' | 'no_such_issuer' | 're_enter_transaction' | 'no_credit_account' | 'pick_up_card_lost' | 'pick_up_card_stolen' | 'closed_account' | 'insufficient_funds' | 'no_checking_account' | 'no_savings_account' | 'expired_card' | 'transaction_not_permitted_to_cardholder' | 'transaction_not_allowed_at_terminal' | 'transaction_not_supported_or_blocked_by_issuer' | 'suspected_fraud' | 'activity_amount_limit_exceeded' | 'restricted_card' | 'security_violation' | 'transaction_does_not_fulfill_anti_money_laundering_requirement' | 'blocked_by_cardholder' | 'blocked_first_use' | 'credit_issuer_unavailable' | 'negative_card_verification_value_results' | 'issuer_unavailable' | 'financial_institution_cannot_be_found' | 'transaction_cannot_be_completed' | 'duplicate_transaction' | 'system_malfunction' | 'additional_customer_authentication_required' | 'surcharge_amount_not_permitted' | 'decline_for_cvv2_failure' | 'stop_payment_order' | 'revocation_of_authorization_order' | 'revocation_of_all_authorizations_order' | 'unable_to_locate_record' | 'file_is_temporarily_unavailable' | 'incorrect_pin' | 'allowable_number_of_pin_entry_tries_exceeded' | 'unable_to_locate_previous_message' | 'pin_error_found' | 'cannot_verify_pin' | 'verification_data_failed' | 'surcharge_amount_not_supported_by_debit_network_issuer' | 'cash_service_not_available' | 'cashback_request_exceeds_issuer_limit' | 'transaction_amount_exceeds_pre_authorized_approval_amount' | 'transaction_does_not_qualify_for_visa_pin' | 'offline_declined' | 'unable_to_go_online' | 'valid_account_but_amount_not_supported' | 'invalid_use_of_merchant_category_code_correct_and_reattempt' | 'card_authentication_failed' — The reason for the decline.
    - `result` 'approve' | 'decline', required — Whether card push transfers or validations will be approved or declined.
  - `prefix` string — The prefix of the card number, usually the first 8 digits.
  - `primary_account_number_length` integer — The total length of the card number, including prefix and last4.

## Response `200`

Card Token

- CardToken — Card Tokens represent a tokenized card number that can be used for Card Push Transfers and Card Validations.
  - `created_at` string, date-time, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time at which the card token was created.
  - `expiration_date` string, date, required — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date when the card expires.
  - `id` string, required — The Card Token's identifier.
  - `last4` string, required — The last 4 digits of the card number.
  - `length` integer, required — The length of the card number.
  - `prefix` string, required — The prefix of the card number, usually 8 digits.
  - `type` 'card_token', required — A constant representing the object's type. For this resource it will always be `card_token`.

## 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)