---
title: "Simulate Authorization"
method: POST
path: "/simulate/authorization"
tags: ["Simulate"]
---

# Simulate Authorization

`POST /simulate/authorization`

Simulate a card transaction

## Request body

- Simulate
  - `card_id` string, required
  - `amount` string, required — Transaction amount as a decimal string using two digits of precision, e.g., "10.00".
  - `transaction_datetime` string — Date and time of transaction YYYY-MM-DD HH:MM
  - `currency` string, required — ISO currency of simulated transaction
  - `merchant_name` string, required — merchant name to be returned in transaction
  - `merchant_city` string, required — merchant city to be returned in transaction
  - `merchant_state` string, required — merchant state to be returned in transaction
  - `merchant_zip_code` string, required — merchant zip code be returned in transaction zip code in 5-digit (12345)
  - `mcc` string, required — merchant category code to be returned in transaction mcc code in 4-digit (1234)
  - `mid` string, required — merchant identifier to be return in the transaction in X-digit (xxxx)

## Response `200`

Example response

- object
  - `transaction_id` string, required
  - `customer_id` string, required
  - `card_id` string, required
  - `raw_statement_descriptor` string, required
  - `account_id` string, required
  - `bond_brand_id` string, required
  - `payment_rail` string, required
  - `amount` string, required
  - `amount_in_cents` string, required
  - `currency_code` string, required
  - `exchange_rate` unknown
  - `transaction_type` string, required
  - `cardholder_presence_indicator` unknown
  - `original_transaction_id` unknown
  - `merchant_name` string, required
  - `merchant_id` unknown
  - `merchant_address` unknown
  - `merchant_country` unknown
  - `merchant_city` string, required
  - `merchant_state` string, required
  - `merchant_zip_code` string, required
  - `mcc` string, required
  - `settled_date` string, required
  - `new_balance` string, required
  - `prior_balance` string, required
  - `transaction_time` string, required
  - `date_created` string, required
  - `date_updated` string, required
  - `fee` unknown
  - `rewards_rate` unknown
  - `rewards` unknown
  - `transaction_state` string, required
  - `origin_timestamp` string, required
  - `transaction_response_code` unknown
  - `acquiring_institution_identification_code` unknown

---

[API](https://skmtc.net/bond/apis/customer.md) · [All operations](https://skmtc.net/bond/apis/customer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bond/customer/revisions/62f5ac53144d/schema)