---
title: "POST /collections/authorize"
method: POST
path: "/collections/authorize"
tags: ["COLLECTIONS"]
---

# POST /collections/authorize

`POST /collections/authorize`

## Headers

- `public-key` string, required
- `x-api-version` number, required
- `Accept-Language` 'en' | 'fr' | 'sw', required

## Request body

- CollectionAuthDto
  - `internal_reference` string, required — Internal/gateway transaction reference
  - `otp` number, required — OTP Auth

## Response `202`

Authorization request accepted.

- IAuthResponseDto
  - `code` number, required — HTTP Status code
  - `status` 'success' | 'accepted' | 'error', required — The status of the response
  - `message` string, required — Response messae
  - `data` object, required — Response data

## Other responses

- `400` — The request is invalid
- `401` — Unauthorized
- `422` — Unprocessable Entity
- `500` — An error occurred while processing the request

---

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