# (Beta, sandbox only) Simulate an unauthorized settlement

Creates a simulated unauthorized settlement.  The API returns a  that corresponds with the created transaction. You can query info about the transaction using GET Index account bookings or GET Index reservations. Please  the following:  The account associated with the card specified in  must have an  

Endpoint: POST /v1/cards/{card_id}/simulator/transactions/settle
Version: 1.0

## Path parameters:

  - `card_id` (string, required)
    ID of the card to use for the test transaction.

## Request fields (application/json):

  - `settlement` (object, required)
    The type of settlement.

  - `settlement.transaction_amount` (string, required)
    The original transaction amount.
    Example: "8"

  - `settlement.amount` (string, required)
    The transaction amount + applicable fees.
    Example: "9"

  - `settlement.transaction_currency` (string, required)
    The currency used in the transaction.
    Example: "EUR"

  - `type` (string, required)
    The type of transaction.
    Enum: "OCT", "PURCHASE", "PURCHASE_REVERSAL", "CASH_ATM_REVERSAL", "CASH_MANUAL_REVERSAL", "CASH_ATM", "CASH_MANUAL", "CREDIT_PRESENTMENT", "DEBIT_PRESENTMENT", "FORCE_POST_TRANSACTION", "DISPUTE_TRANSACTION", "FRAUD_TRANSACTION"

  - `pos_entry_mode` (string, required)
    The POS entry mode used to complete the transaction.
    Enum: "UNKNOWN", "MAG_STRIPE", "CHIP", "MANUAL_PAN_ENTRY", "CONTACTLESS", "CARD_NOT_PRESENT"

  - `merchant_category_code` (string, required)
    The merchant category code (should be 4 digits).
    Example: "5411"

  - `acquirer_id` (string, required)
    The acquirer ID (up to 6 digits).
    Example: "123456"

  - `approval_code` (string, required)
    The approval code (should be 6 digits).
    Example: "053630"

  - `terminal_id` (string, required)
    Terminal ID (should be 10 digits).
    Example: "1234567890"

  - `merchant_id` (string, required)
    Merchant ID (should be 15 digits).
    Example: "123456789101112"

  - `merchant_name` (string, required)
    The merchant's name (max 25 characters).
    Example: "Solarisbank AG"

  - `merchant_city` (string, required)
    The merchant's city (max 13 characters).
    Example: "Berlin"

  - `merchant_country` (string, required)
    The merchant's country (ISO 3166 two-character code).
    Example: "DE"

## Response 202 fields (application/json):

  - `transaction_key` (string, required)
    ID of the created authorization.
    Example: "100000000142424"

## Response 400 fields (application/json):

  - `timestamp` (string)

  - `status` (integer)
    Example: 400

  - `error` (string)
    Example: "Bad Request"

  - `message` (string)
    Example: "ISO2 Country Code is an invalid"

  - `path` (string)
    Example: "/v1/cards/847dc1d0144a3d923cadf2c62a2839d0mcrd/simulator/transactions"

## Response 403 fields (application/json):

  - `id` (string)
    Example: "a95f2aaf-4e0c-4d49-8021-8a16a884ed86"

  - `status` (string)
    Example: "403"

  - `code` (string)
    Example: "unauthorized_action"

  - `title` (string)
    Example: "Unauthorized Action"

  - `detail` (string)
    Example: "Unauthorized action is not allowed."

## Response 404 fields (application/json):

  - `timestamp` (string)

  - `status` (integer)
    Example: 404

  - `error` (string)
    Example: "Not Found"

  - `message` (string)
    card not found or not related to the partner
    Example: "404 NOT_FOUND"

  - `path` (string)
    Example: "/v1/cards/847dc1d0144a3d923cadf2c62a2839d0mcrd/simulator/transactions"

## Response 500 fields (application/json):

  - `timestamp` (string)

  - `status` (integer)
    Example: 500

  - `error` (string)
    Example: "Internal Server Error"

  - `message` (string)
    Example: "503 Service Temporarily Unavailable"

  - `path` (string)
    Example: "/v1/cards/847dc1d0144a3d923cadf2c62a2839d0mcrd/simulator/transactions"