---
title: "Simulate Authorization"
method: POST
path: "/v1/simulation/issuing/authorization"
tags: ["Simulator"]
---

# Simulate Authorization

`POST /v1/simulation/issuing/authorization`

Simulate an authorization type transaction by including the `card_id` and other authorization details in your request.
Only cards with BINs below are supported for simulation.
- `40963608`

## Headers

- `x-on-behalf-of` string
- `x-idempotency-key` string, uuid

## Request body

- SimulateAuthorizationRequest
  - `card_id` string, required — Unique identifier for the card.
  - `transaction_amount` number, required — The transaction amount to simulate.
  - `transaction_currency` string, required — Currency of the transaction.
  - `merchant_name` string, required — Name of the merchant
  - `merchant_category_code` string, required — The merchant category code for the merchant's business. Can only be `5734`.

## Response `200`

Authorization simulated successfully.

- SimulateAuthorizationResponse
  - `card_id` string, required — Unique identifier for the card.
  - `card_number` string, required — Masked card number
  - `cardholder_id` string, uuid, required — The cardholder's unique identifier.
  - `transaction_id` string, uuid, required — Unique Identifier for transaction
  - `transaction_type` 'AUTHORIZATION' | 'REFUND' | 'REVERSAL', required — The type of transaction being simulated.
  - `card_available_balance` number, required — The card available balance.
  - `authorization_code` string, required — Authorization Code
  - `billing_amount` number, required — Billing amount
  - `billing_currency` string, required — Billing Currency
  - `transaction_amount` number, required — Transaction amount
  - `transaction_currency` string, required — Transaction currency
  - `transaction_time` string, required — Transaction occurrence time
  - `posted_time` string — Transaction posted time
  - `merchant_data` MerchantData — Details about the merchant (grocery store, e-commerce website, etc.) involved in this transaction.
    - `category_code` string — The merchant category code for the merchant's business.
    - `city` string — City where the merchant is located
    - `country` string — Country where the merchant is located
    - `name` string — Name of the merchant
  - `failure_reason` string, required — Reason for transaction failure.
  - `transaction_status` 'APPROVED' | 'DECLINED', required — The high-level status indicating the stage of the transaction lifecycle.

---

[API](https://skmtc.dev/uqpay/apis/authentication-api.md) · [All operations](https://skmtc.dev/uqpay/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uqpay/authentication-api/revisions/cef532a10777/schema)