---
title: "Simulate Authorization"
method: POST
path: "/cards/simulator/authorization"
---

# Simulate Authorization

`POST /cards/simulator/authorization`

Simulates different types of authorizations across several merchant categories and channels.

## Request body

- object
  - `cardId` string, required — The `_id` of the card.
  - `channel` 'web' | 'pos' | 'atm', required — The channel to simulate the authorization on.
  - `type` 'purchase' | 'cash_withdrawal' | 'deposit' | 'transfer' | 'payment', required — The authorization type.
  - `amount` number, float, required — The amount to simulate.
  - `currency` 'NGN' | 'USD', required — The currency type.
  - `merchant` object, required — The merchant information.
    - `category` string, required — The merchant category
    - `merchantId` string, required — The `_id` of the merchant.
    - `name` string, required — The merchant name.
    - `city` string, required — The city the merchant is located.
    - `state` string, required — The two letter code of the state the merchant is located in.
    - `country` string, required — The two letter code of the country the merchant is located in.

## Response `200`

Simulated successfully.

- object
  - `statusCode` integer — Status code of the response. `200` indicates a successful request.
  - `message` string — Human-readable description of the result.

## Other responses

- `400` — Validation error.
- `401` — Authentication failed — missing or invalid API key.

---

[API](https://skmtc.net/sudo/apis/sudo-sandbox-api.md) · [All operations](https://skmtc.net/sudo/apis/sudo-sandbox-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sudo/sudo-sandbox-api/versions/52be624fcb53/schema)