---
title: "Request Authorisation"
method: POST
path: "/frequent/authorisation/{id}"
tags: ["Frequent Payment"]
---

# Request Authorisation

`POST /frequent/authorisation/{id}`

Create a new authorisation on a given Frequent Payment

**Required scope:** <code style="background:#e8f0fe;color:#1a73e8;padding:2px 8px;border-radius:12px;font-size:0.85em">frequent:create</code>

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `mbway_sdk` object — MB WAY SDK configuration for payment processing
    - `purchase_token` string — Purchase token for MB WAY SDK
    - `initial_timestamp` string — Initial timestamp for the transaction
    - `merchant_operation_id` string — unique-concatenation between client identifier and client operation id.
    - `payload` string — JSON payload for MB WAY SDK
  - `transaction_key` string — Your internal key identifying this authorisation.
  - `force_3ds` boolean — Whether or not you want to force the 3DS authentication.
  - `descriptive` string, required — This will appear in the bank statement/MB WAY application.
  - `value` number, double, required — Value will be rounded to 2 decimals.

## Response `201`

Created

- object
  - `id` string, uuid — Unique identifier for the authorization
  - `status` string — Status of the request
  - `message` string[] — Array of status messages

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `412` — Pre condition failed
- `429` — Too Many Requests
- `500` — Internal Server Error

---

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