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

# (Beta, sandbox only) Simulate an authorization

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

Creates a simulated card authorization for the purpose of testing approval & denial flows.<br>  Calling this endpoint will trigger a **webhook notification** on [CARD_AUTHORIZATION](https://docs.solarisgroup.com/api-reference/webhooks/#card_authorization) or [CARD_AUTHORIZATION_DECLINE_V2](https://docs.solarisgroup.com/api-reference/webhooks/#card_authorization_decline_v2) (depending on whether the test transaction should be approved or declined).<br>  The API returns a `transaction_key` corresponding 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>This is a **beta endpoint.**</li> <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

- TransactionSimulatorRequest
  - `type` 'PURCHASE' | 'CASH_ATM' | 'OCT', required — The type of transaction.
  - `authorization` Authorization, required
    - `amount` string, integer, required
    - `transaction_amount` string, integer, required
  - `transaction_currency` string, required — Currency code of the transaction.
  - `pos_entry_mode` 'CHIP' | 'CONTACTLESS' | 'MAG_STRIPE' | 'MANUAL_PAN_ENTRY' | 'UNKNOWN', 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 — Terminal ID (should be 8 digits).
  - `merchant_id` string, integer, required — Merchant ID (should be 15 digits).
  - `merchant_name` string, required — The merchant's name (up to 24 characters).
  - `merchant_city` string, required — The merchant's city (up to 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)