メインコンテンツへスキップ
POST
curl
メモは判定ではなく補足情報です。取引のstatus、score、アラートを変更することはありません。レビュアーはConsoleの取引詳細のメモでメモを確認できます。また、取引のactivitiesにTRANSACTION_NOTE_ADDEDのエントリが追加され、取引の取得で参照できます。 メモはAPIキーから作成されるため、作成者情報を持ちません。actor_emailとactor_nameはnullになります。作成者を表示する必要がある場合は、メモの本文に含めてください。タイムライン全体は取引メモ一覧の取得で取得できます。

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business ConsoleのDevelopers -> API keysで取得できます。プライマリキーはフルアクセス権を持ちます。名前付きキーにはスコープを設定できます。リソースごとのアクセス権(なし、読み取り、書き込み)、一部のワークフローまたは承認済みセッションへの限定、IPアドレスのリストへの限定、有効期限の設定です。401は、キーが誤っている、失効している、または期限切れであることを意味します。403は、キーが送信されていない、キーにこのリソースやアクションへのアクセス権がない、またはIPリスト外のアドレスからリクエストが送信されたことを意味します。セッションのルートでの404は、セッションがキーのワークフローまたはステータスの対象外であることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLがnullで返されます。セッションの書き込み権限がないキーでは、セッションのリンクとトークンがnullで返されます。詳細は次を参照してください: https://docs.didit.me/console/api-keys

パスパラメータ

transaction_id
string<uuid>
必須

Diditの取引UUIDで、POST /v3/transactions/およびGET /v3/transactions/が返すuuidです。独自のtxn_idは受け付けられません。

ボディ

application/json
note
string
必須

プレーンテキストのメモ。先頭と末尾の空白は削除され、空のメモは拒否されます。文字数の制限はありません。

Minimum string length: 1
mentioned_emails
string<email>[]

メンションする組織メンバーのメールアドレス。それぞれが組織メンバーの有効なメールアドレスである必要があります。

レスポンス

メモが作成されました。

モニタリング対象取引のレビュータイムライン上のメモ1件。

uuid
string<uuid>
必須

メモの識別子。

note
string
必須

プレーンテキストのメモ本文。

actor_email
string<email> | null
必須

メモを書いた、またはステータスを変更したConsoleユーザーのメールアドレス。APIキーで作成されたメモおよびDiditが自動的に追加したメモの場合はnull。

actor_name
string | null
必須

Consoleユーザーの表示名です(名前がない場合はメールアドレス)。Diditが自動的に追加するメモではRule Engineとなります。APIキーで作成されたメモではnullです。

metadata
object
必須

ノートの種類を区別します。APIまたはConsoleで作成されたノートにはmentioned_emailsが含まれます。Consoleで行われたステータス変更には、type: status_changeとprevious_status、new_status、reason_code、reason_labelが含まれます。Diditが追加するノートにはsourceが含まれ、ルールのadd_noteアクションによるものはrule_action(rule_uuid付き)、ユーザーアクション用の認証セッションの作成で問題が発生した場合はremediation_sessionとなります。

created_at
string<date-time>
必須

メモが保存された日時。

最終更新日 2026年11月1日