---
title: "Authorize Transaction"
method: POST
path: "/card/auth_capture/authorize"
tags: ["Auth-Capture-Void"]
---

# Authorize Transaction

`POST /card/auth_capture/authorize`

This endpoint authorizes a transaction and holds funds for a specified period. This endpoint handles payout requests.

> **Record Creation:**
>
> Authorization record is created with **PENDING** status before MPGS call, then updated to **AUTHORIZED** on success or **FAILED** on error.
>

## Request body

- unknown

## Response `200`

Authorize Transaction

- AuthorizeTransactionResponse
  - `status` string — Status of the authorization (AUTHORIZED, PENDING, DECLINED).
  - `message` string — Descriptive message about the status.
  - `authorization_reference` string, nullable — Unique reference for the authorization.
  - `authorization_code` string, nullable — Code provided by the issuer if authorized.
  - `authorized_amount` number, nullable — The amount successfully held.
  - `currency` string, nullable — Currency code.
  - `expires_at` string, date-time, nullable — Timestamp when the hold expires.
  - `do3dsAuth` boolean — Indicates if 3D Secure authentication is required.
  - `threeDsUrl` string, uri, nullable — URL to redirect for 3DS authentication.
  - `threeDsHtml` string, nullable — HTML content for 3DS page rendering.
  - `formData` string, nullable — Form data (cReq/PaReq) for 3DS.
  - `error_code` string, nullable — Error code if declined.
  - `error_message` string, nullable — Detailed error description.

## Other responses

- `400` — Invalid request

---

[API](https://skmtc.net/payaza/apis/payaza-documentation.md) · [All operations](https://skmtc.net/payaza/apis/payaza-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/payaza/payaza-documentation/versions/1ecd4b94ff07/schema)