---
title: "Simulate authorization"
method: POST
path: "/issuing/simulate/authorizations"
tags: ["Card testing"]
---

# Simulate authorization

`POST /issuing/simulate/authorizations`

## Request

- Base URL: `https://{prefix}.api.sandbox.checkout.com`
- URL: `https://{prefix}.api.sandbox.checkout.com/issuing/simulate/authorizations`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `string` scopes: `issuing:transactions-write`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/issuing/simulate/authorizations/post.ts> (a function with typed inputs; its response is checked against the schema)

Simulate an authorization request with a card you issued previously.

## Request body

- SimulateAuthorizationRequest
  - `card` IssuingSimulateCard: The card to simulate an authorization with.
    - `id` string, required: The card's unique identifier.
    - `expiry_month` integer: The card's expiration month.
    - `expiry_year` integer: The card's expiration year.
  - `transaction` IssuingSimulateTransaction: The transaction to simulate with the specified card. For example, a purchase.
    - `type` string, required: The transaction type.
    - `amount` integer: The payment amount, in <a href="https://www.checkout.com/docs/resources/calculating-the-amount" target="blank">minor currency units</a>. To perform a card verification, set `amount` to `0`, or omit the field entirely.
    - `currency` string: The currency to use for the transaction, as a three-letter <a href="https://www.checkout.com/docs/resources/codes/currency-codes" target="blank">ISO currency code</a>. If this currency differs from the cardholder's billing currency, the billing amount will be adjusted according to the applicable conversion rate. If no currency is provided, the transaction will default to the cardholder's billing currency.
    - `merchant` IssuingMerchant: The merchant related data to use for the transaction.
      - `category_code` string: The <a href="https://www.checkout.com/docs/resources/codes/merchant-category-codes" target="blank">merchant category code (MCC)</a>, which determines the types of businesses the card can process the transaction from.
    - `authorization_type` 'authorization' | 'pre_authorization': Use `authorization` for a known final amount or `pre_authorization` for an estimated amount.

## Response `201`

Authorization processed successfully

- SimulateAuthorizationResponse: Authorization Response.
  - `id` string: The transaction's unique identifier. This same ID is carried throughout all authorization, reversal, and clearing messages related to the given transaction.
  - `status` 'Authorized' | 'Declined', required: The transaction's status.

## Other responses

- `401`: Unauthorized
- `422`: Invalid data was sent
- `500`: Internal Server Error

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)