---
title: "Authorise Charge"
method: POST
path: "/api/b2b/fiat/deposit/{transactionId}/authorise"
---

# Authorise Charge

`POST /api/b2b/fiat/deposit/{transactionId}/authorise`

## Request

- Base URL: `https://api-v2.honeycoin.app`
- URL: `https://api-v2.honeycoin.app/api/b2b/fiat/deposit/{transactionId}/authorise`
- Auth: API key in header `Authorization`

Submit the required authorisation data (OTP, PIN, or Address) to move the transaction forward.

## Path parameters

- `transactionId` string, required

## Request body

- object
  - `type` 'three_ds' | 'otp' | 'pin' | 'address_verification', required: Submit the current required authorization step. Redirect steps use the returned URL. Sandbox rejects a mismatched step or a transaction belonging to another account or already successful/failed.
  - `value` union, required: String value for three_ds, otp, or pin; billing address object for address_verification.
    - string
    - object
      - `street1` string, required
      - `street2` string
      - `state` string, required
      - `zip` string, required
      - `city` string, required
      - `country` string, required

## Response `200`

200

- object
  - `success` boolean
  - `message` string

## Other responses

- `400`: 400

## Changes

- **2026-11-03** `fcb58b0ef441`: 3 breaking, 5 info
  - added `subschema #1` to the request body `allOf` list
  - request property `type` was restricted to a list of enum values
  - the `value` request property type changed from `string` to no type
  - added the new `address_verification` enum value to the request property `type`
  - …4 more

[Operation history](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/changes/api/b2b/fiat/deposit/:transactionId/authorise/post.md)

---

[API](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official.md) - [All operations](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/llms.txt) - [OpenAPI document](https://skmtc.dev/honeycoin/apis/honeycoin-v3-api-official/revisions/fcb58b0ef441?raw)
