---
title: "Authorize a charge"
method: POST
path: "/checkout/charges/{id}/authorize"
---

# Authorize a charge

`POST /checkout/charges/{id}/authorize`

This API lets you authorize a charge on a card or mobile money payment

## Path parameters

- `id` string, required

## Headers

- `x-business-id` string

## Request body

- object
  - `pin` string — Transaction pin of the card to charge if the auth_model is PIN
  - `otp` string — one time password to be used to complete the request if the auth_model is OTP
  - `avs` string — Object containing AVS details. This should be present if the auth_model is AVS
  - `state` string — The state registered with the card. Required if auth_mode is AVS
  - `city` string — The city registered with the card. Required if auth_mode is AVS
  - `country` string — The country registered with the card. Required if auth_mode is AVS
  - `address` string — The address registered with the card. Required if auth_mode is AVS
  - `zip_code` string — The zip code registered with the card. Required if auth_mode is AVS

## Response `200`

200

- object
  - `status` boolean
  - `message` string
  - `data` object
    - `id` integer
    - `authorization` object
      - `mode` string
    - `auth_model` string
    - `amount` integer
    - `currency` string
    - `message` string
    - `status` string
    - `reference` string

## Other responses

- `400` — 400

---

[API](https://skmtc.net/fincra/apis/awesome-new-api.md) · [All operations](https://skmtc.net/fincra/apis/awesome-new-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fincra/awesome-new-api/revisions/c8215c27b460/schema)