---
title: "Simulate Authorization Reversal"
method: GET
path: "/cards/simulator/authorization/{id}/reversal"
---

# Simulate Authorization Reversal

`GET /cards/simulator/authorization/{id}/reversal`

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

## Path parameters

- `id` string, required

## Response `200`

Authorization reversed successfully.

- object
  - `statusCode` integer — Status code of the response. `200` indicates a successful request.
  - `message` string — Human-readable description of the result.
  - `data` object — Response payload.
    - `_id` string — Unique identifier of the object.
    - `business` string — Identifier of the business that owns this object.
    - `customer` object — Associated customer — an id, or a summary object on nested resources.
      - `_id` string — Unique identifier of the object.
      - `name` string — Display name.
    - `account` object — Associated account — an id, or a summary object on nested resources.
      - `_id` string — Unique identifier of the object.
      - `type` string — Type of the object.
      - `currency` string — ISO 4217 currency code (e.g. `NGN`).
      - `accountName` string — Name on the account.
      - `accountNumber` string — Account number (NUBAN).
    - `card` object — Associated card — an id, or a summary object on nested resources.
      - `_id` string — Unique identifier of the object.
      - `type` string — Type of the object.
      - `brand` string — Card scheme/brand (e.g. `Verve`, `MasterCard`).
      - `currency` string — ISO 4217 currency code (e.g. `NGN`).
      - `maskedPan` string — Masked card number (PAN).
    - `pendingRequest` object — Details of the amount currently being authorized.
      - `amount` integer — Amount in the minor currency unit (e.g. kobo).
      - `currency` string — ISO 4217 currency code (e.g. `NGN`).
      - `merchantAmount` integer — Amount in the merchant's currency.
      - `merchantCurrency` string — Merchant's ISO 4217 currency code.
    - `transactionMetadata` object — Channel and reference metadata for the transaction.
      - `channel` string — Channel the transaction occurred on (`web`, `pos`, `atm`).
      - `type` string — Type of the object.
      - `reference` string — Unique reference assigned to the object.
    - `amount` integer — Amount in the minor currency unit (e.g. kobo).
    - `fee` integer — Fee charged, in the minor currency unit.
    - `vat` integer — VAT charged, in the minor currency unit.
    - `approved` boolean — Whether the authorization was approved.
    - `currency` string — ISO 4217 currency code (e.g. `NGN`).
    - `status` string — Current status of the object.
    - `authorizationMethod` string — How the authorization was performed.
    - `createdAt` string, date-time — ISO 8601 timestamp of when the object was created.
    - `updatedAt` string, date-time — ISO 8601 timestamp of when the object was last updated.
    - `__v` integer — Internal document version (Mongo).

## 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)