メインコンテンツへスキップ
POST
curl

承認

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

ボディ

application/json
transaction_id
string
必須

この取引に対するお客様独自の識別子です(最大128文字)。

例:

"your-txn-2026-05-17-001"

transaction_category
enum<string>
必須

取引のカテゴリ。キャメルケースのエイリアス(travelRule、userPlatformEvent、gamblingBetなど)も受け付けます。複数語のカテゴリでは、保存および返却される値はキャメルケースです。

利用可能なオプション:
finance,
kyc,
travel_rule,
user_event,
audit_trail_event,
gambling_bet,
gambling_limit_change,
gambling_bonus_change,
travelRule
例:

"finance"

transaction_details
object
必須

取引の主要な金融情報。

subject
object
必須

取引の対象者(申請者)。

transaction_at
string<date-time>

取引が発生した日時。省略した場合は現在日時になります。

time_zone
string

IANAタイムゾーン識別子。例: Europe/Madrid。

counterparty
object

取引の取引相手(任意)。

custom_properties
object

取引に付与する任意のキーと値のペア。各キーは、ルール条件でフィールドパスcustom_values.<key>を使って参照できます。

例:
travel_rule_details
object

トラベルルールのデータ。トラベルルールが有効で、transaction_categoryがtravel_ruleの場合は、Didit自身が交換を実行します。この場合、status、protocol、required、obligations_countは無視され、originator_data、beneficiary_data、metadataが使用されます。それ以外の場合、Diditはこれらの値を受動的なトラベルルール記録として保存します。トラベルルールが有効な間は、設定したしきい値以上のアウトバウンド送金に、その規制(EU TFRまたはFATF勧告16)が求める情報を含める必要があり、送信した側について確認されます。フィールドが不足している場合は、travel_rule_details.originator_dataまたはtravel_rule_details.beneficiary_dataの下で400が返されます。例:「EU TFR requires the originator name.」

network_snapshot
object

事前に計算されたネットワークグラフのスナップショット。

include_crypto_screening
boolean | null

暗号資産のブロックチェーン分析スクリーニングに対する取引ごとの上書き設定です。trueの場合、アプリケーションのデフォルトに関係なく暗号資産スクリーニングが実行されます。falseの場合、アプリケーションの設定で有効になっていても暗号資産スクリーニングはスキップされます。省略した場合またはnullの場合は、Consoleで設定したアプリケーションレベルのデフォルトが使用されます。暗号資産スクリーニングには、transaction_details.direction、currency_kind: "crypto"、チェーン/通貨、および方向に応じて選択されるウォレットアドレスが必要です。入金の送金前スクリーニングではcounterparty.payment_method.account_id、入金のトランザクションハッシュによるスクリーニングではsubject.payment_method.account_id、出金のスクリーニングではcounterparty.payment_method.account_idが使用されます。transaction_details.payment_reference_idにブロックチェーンのトランザクションハッシュが含まれている場合、Diditは取引スクリーニングを実行し、利用可能な場合は取引サマリーのエンリッチメント情報を返します。

レスポンス

取引が送信され、モニタリングされています。本文は取引の完全な詳細(GET /v3/transactions/{transaction_id}/と同じ形式)で、すでに適用されたルールの結果を反映しています。

1件の取引に関する完全なモニタリング記録。GET /v3/transactions/{transaction_id}/およびPOST /v3/transactions/から返されます。

uuid
string<uuid>

Diditの安定した取引識別子です。後続の呼び出しで{transaction_id}として使用します。

environment
enum<string>

取引を所有するアプリケーションの環境。sandboxの取引は保存されますが、評価、スクリーニング、通知、請求は一切行われません。そのため、空のrule_runsは「未評価」を意味します。

利用可能なオプション:
live,
sandbox
transaction_number
integer

Consoleに表示される、アプリケーション単位の取引の連番(例: 4123)。

txn_id
string

作成時に指定したtransaction_id(最大128文字)。アプリケーションごとに一意です。

txn_date
string<date-time>

取引が発生した日時(transaction_atの値。デフォルトは送信日時)。

zone_id
string | null

作成時に指定されたIANAタイムゾーン識別子。

transaction_type
string

保存されている最上位カテゴリー: finance、kyc、travelRule、userPlatformEvent、gamblingBet、gamblingLimitChange、gamblingBonusChange、auditTrailEvent。複数語の値は、snake_caseで送信した場合でもcamelCaseで返される点に注意してください。

action_type
string

カテゴリ内のサブタイプ(例: deposit、withdrawal、transfer)。指定しない場合はカテゴリがデフォルトになります。

direction
enum<string>

対象者から見た方向です。送信時の大文字・小文字にかかわらず大文字で保存されます(入力ではin/out/inbound/outboundを受け付けます)。

利用可能なオプション:
INBOUND,
OUTBOUND
status
enum<string>

現在のモニタリング判定。取引はAPPROVEDで作成され、ルールによって同期的にIN_REVIEW/DECLINEDに変更される場合があります。

利用可能なオプション:
APPROVED,
IN_REVIEW,
DECLINED,
AWAITING_USER
source
enum<string>

レコードの発生元:APIまたはSDKで送信された取引はLIVE、コンソールのインポートで読み込まれた取引はIMPORTED。

利用可能なオプション:
LIVE,
IMPORTED
amount
string

末尾のゼロを除去した10進数文字列で表した取引金額(例: "1500"、"0.5"、"0.123456789012345678")。小数点以下最大18桁です。

currency
string

amountの通貨コード。ISO 4217の任意のアルファベットコード(例: EUR、USD、NGN)と暗号資産シンボル(例: BTC)を受け付けます。現在流通しているコードを推奨します。受け付けられるすべてのコードに為替レートがあるわけではありません。コードに為替レートがない場合(たとえばISOの会計単位XSUや、Diditが価格を付けていない暗号資産シンボル)、自動換算は失敗し、リクエストで換算済みのamount_in_default_currencyを指定していない限りpreferred_currency_amountはnullで返されます。

currency_type
string | null

currency_kindで送信されたとおりのfiatまたはcrypto。

amount_in_default_currency
string | null

指定された事前換算済みの金額。末尾のゼロを除いた10進数の文字列です。

default_currency_code
string | null
preferred_currency_amount
string | null

利用可能な場合に、アプリケーションの優先通貨に換算したamountです。

preferred_currency_code
string | null
payment_details
string | null

送信内容に含まれる自由記述の支払い参照情報またはメモ。

payment_txn_id
string | null

payment_reference_idから取得した外部決済システムの参照番号です(例: ブロックチェーンの取引ハッシュ)。

score
integer

ルールによって累積されたリスクスコア(通常0~100)。値が高いほどリスクが高くなります。

severity
enum<string> | null

ルールまたはプロバイダーが設定するカテゴリ別のリスク重大度(UNKNOWN、LOW、MEDIUM、HIGH、CRITICAL)。いずれかによって設定されるまではnullです。

利用可能なオプション:
UNKNOWN,
LOW,
MEDIUM,
HIGH,
CRITICAL
decision_reason_code
string | null

現在のstatusの機械可読な理由。

decision_reason_label
string | null

decision_reason_codeの人が読めるラベル。

vendor_data
string | null

申請者のvendor_dataの便宜上のコピー。

metadata
object

作成時に送信されたsubjectおよびcounterpartyペイロードのスナップショット。

props
object

作成時に指定したcustom_propertiesです。各キーはルールの条件内でcustom_values.<key>として参照できます。

tags
object[]

取引に付与されたタグ(手動またはルールによる)。

parties
object[]

取引の当事者(申請者、取引相手)。

payment_methods
object[]

取引に紐づく支払い方法。

documents
object[]

コンソールから取引に添付されたファイル。ない場合は[]です。

activities
object[]

アクティビティログのエントリ(作成、メモ、手動レビュー、ステータスの変更)。

alerts
object[]

現在は常に空です。未対応のアラートとは、ステータスがIN_REVIEWまたはAWAITING_USERの取引です。

rule_runs
object[]

ルールごとの実行結果です。どのルールが発動し、スコアにどのような影響を与えたかを示します。

provider_results
object[]

プロバイダーの生のペイロード(AMLスクリーニング、ブロックチェーン分析など)。

travel_rule
object | null

トラベルルールの送金またはチェック。travel_rule_detailsが送信された場合に設定されるほか、トラベルルールが有効で、取引がtransaction_category: travelRuleで作成された場合にも設定されます(travel_rule_detailsがなくても、Didit自身が交換を開始します)。送金やチェックが存在しない場合はnullです。インバウンド送金では、ウォレットの所有権が確認されるまで、取引相手のoriginator_dataとbeneficiary_dataはマスクされたまま(data_masked: true)になります。

network_snapshot
object | null

ルールエンジンが使用する、関連する取引と当事者のグラフスナップショット。取引とともに送信されたnetwork_snapshot、またはAMLウォレットスクリーニングが成功した際にDiditが構築するグラフ(送信されたものを置き換えます)のいずれかです。どちらも存在しない場合はnullです。

remediation
object | null

再検証が必要な場合にユーザーに提示される是正用のセッションです。正規のブロックであるaction_requiredに置き換えられました。後方互換性のために残されています。

action_required
Verification session · object

この取引を完了するために必要な保留中のエンドユーザーアクション。存在しない場合はnull。Didit SDKはデフォルトでこのアクションを自動的に起動し、完了時に取引を更新します。typeで区別される2つのバリアントがあります。verification_session(ルールのアクションによって作成されたホスト型認証セッション)とwallet_ownership(ウォレット管理の証明が必要なトラベルルール送金のために自動発行されるウォレット所有権ウィジェットセッションで、トラベルルール設定のauto_wallet_verificationによって制御されます)です。両方が該当しうる場合は、トラベルルールの交換をブロックするためwallet_ownershipが優先されます。

cost_breakdown
object | null

この取引の費用。total_priceとitemsで構成され、itemsは請求ごとに1件で、それぞれusage_type、price、details、created_atを含みます。同じ取引を再スクリーニングすると新しい項目になります。

最終更新日 2026年11月1日