# (Beta, sandbox only) Simulate an authorization

Creates a simulated card authorization for the purpose of testing approval & denial flows.  Calling this endpoint will trigger a  on CARD_AUTHORIZATION or CARD_AUTHORIZATION_DECLINE_V2 (depending on whether the test transaction should be approved or declined).  The API returns a  corresponding with the created transaction. You can query info about the transaction using GET Index account bookings or GET Index reservations. Please  the following:  This is a  The account associated with the card specified in  must have an  

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

## Path parameters:

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

## Request fields (application/json):

  - `type` (string, required)
    The type of transaction.
    Enum: "PURCHASE", "CASH_ATM", "OCT"

  - `authorization` (object, required)
    The amount of the card authorization.

  - `authorization.amount` (string, required)
    Example: "000000004023"

  - `authorization.transaction_amount` (string, required)
    Example: "000000004023"

  - `transaction_currency` (string, required)
    Currency code of the transaction.
    Example: "USD"

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

  - `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"

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

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

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

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

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

  - `terminal_id` (string)
    Terminal ID (should be 8 digits).
    Example: "12345678"

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