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

承認

X-Transaction-Token
string
header
必須

バックエンドがPOST /v3/transactions/sdk-token/で発行する有効期間の短いスコープ付きトークン。Didit SDKがデバイス向けの/v1/transactions/エンドポイントで使用します。

ボディ

application/json
txnId
string
必須

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

例:

"wd-2026-07-07-0042"

type
string
必須

取引カテゴリー(transaction_categoryに対応)。例: finance、kyc、travelRule、userPlatformEvent、gamblingBet。

例:

"travelRule"

info
object
必須

取引の主要な金融情報(transaction_detailsに対応)。

subject
object
必須

取引の対象者(申請者)。ここではexternalUserIdは無視されます。対象者の身元は常にトークンのvendor_dataに基づいて強制されます。

txnDate
string<date-time>

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

zoneId
string

IANAタイムゾーン識別子(time_zoneに対応)。例: Europe/Madrid。

counterparty
object

取引の取引相手(任意)。subjectと同じ形式です。ここではexternalUserIdが意味を持ちます。

props
object

カスタムのキーと値のペア(custom_propertiesに対応)。各キーはルール条件でcustom_values.<key>として参照できます。

travelRule
object

トラベルルールの詳細(travel_rule_detailsに対応)。アプリケーションでトラベルルールが有効な場合、Diditは送信されたstatusを無視し、交換を自ら進めます。

includeCryptoScreening
boolean | null

暗号資産のブロックチェーン分析スクリーニングに対する取引ごとの上書き設定です(include_crypto_screeningに対応します)。

fingerprint_v2
object

didit-fp-v2デバイスフィンガープリントのペイロードです。SDKが自動的に挿入します。ワイヤーAPIを直接呼び出す場合にのみ関係します。

レスポンス

取引が送信され、モニタリングされています。詳細の形式はGET /v3/transactions/{transaction_id}/と同じで、エンドユーザーがフォローアップのアクションを完了する必要がある場合はaction_requiredブロックを含みます(SDKはデフォルトでこれを自動的に起動します)。

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日