---
title: "(Beta, sandbox only) Simulate an unauthorized settlement"
method: POST
path: "/v1/cards/{card_id}/simulator/transactions/settle"
tags: ["Card transactions simulation"]
---

# (Beta, sandbox only) Simulate an unauthorized settlement

`POST /v1/cards/{card_id}/simulator/transactions/settle`

Creates a simulated unauthorized settlement.  The API returns a `transaction_key` that corresponds with the created transaction. You can query info about the transaction using [GET Index account bookings](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/#tag/Accounts/paths/~1v1~1accounts~1{account_id}~1bookings/get) or [GET Index reservations](https://docs.solarisgroup.com/api-reference/digital-banking/account-management/#tag/Reservations/paths/~1v1~1accounts~1{account_id}~1reservations/get).<br> Please **note** the following: <ul> <li>The account associated with the card specified in `card_id` must have an **available balance.**</li> </ul>

## Path parameters

- `card_id` string, required

## Request body

- TransactionSimulatorStandaloneSettleRequest
  - `settlement` Settlement, required
    - `amount` string, integer, required — The transaction amount + applicable fees.
    - `transaction_amount` string, integer, required — The original transaction amount.
    - `transaction_currency` string, required — The currency used in the transaction.
  - `type` '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', required — The type of transaction.
  - `pos_entry_mode` 'UNKNOWN' | 'MAG_STRIPE' | 'CHIP' | 'MANUAL_PAN_ENTRY' | 'CONTACTLESS' | 'CARD_NOT_PRESENT', required — The POS entry mode used to complete the transaction.
  - `merchant_category_code` string, integer, required — The merchant category code (should be 4 digits).
  - `acquirer_id` string, integer, required — The acquirer ID (up to 6 digits).
  - `approval_code` string, integer, required — The approval code (should be 6 digits).
  - `terminal_id` string, integer, required — Terminal ID (should be 10 digits).
  - `merchant_id` string, integer, required — Merchant ID (should be 15 digits).
  - `merchant_name` string, required — The merchant's name (max 25 characters).
  - `merchant_city` string, required — The merchant's city (max 13 characters).
  - `merchant_country` string, ISO 3166 alpha-2, required — The merchant's country (ISO 3166 two-character code).

## Response `202`

The operation was successful.

- TransactionSimulatorResponse
  - `transaction_key` string, required — ID of the created authorization.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — The resource could not be found.
- `500` — Internal server error.

---

[API](https://skmtc.net/solarisgroup/apis/card-creation-servicing.md) · [All operations](https://skmtc.net/solarisgroup/apis/card-creation-servicing/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarisgroup/card-creation-servicing/revisions/a772504dcc9e/schema)