メインコンテンツへスキップ
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
wallet_address
string

検証するウォレットアドレス。任意です。空の場合は、証明の開始時にアドレスを指定する必要があります。

Maximum string length: 128
chain
string

アドレスのチェーントークンです(例: ETH、BTC、SOL)。ウォレットのアドレス帳と同じトークンを使用してください。メッセージ署名とSatoshiテストは、サポート対象のチェーンでのみ提供されます。証明によって検証されるアドレス帳エントリーには、正規の識別子(ETH、BTC、SOL、TRX)で保存されます。

Maximum string length: 32
holder_name
string

受取人名の照合に使用されるウォレット保有者の名前。

Maximum string length: 255
vendor_data
string

保有者に対するお客様の内部識別子で、作成されるアドレス帳エントリに引き継がれます。

Maximum string length: 255
transaction_id
string<uuid> | null

任意。証明が検証されたときに進めるトラベルルール送金のDidit取引UUIDです。

satoshi_deposit_address
string

任意。お客様が管理する入金アドレスです。指定するとSATOSHI_TEST証明方式が有効になります。

Maximum string length: 128
callback_url
string

任意。完了後にウィジェットが顧客を戻す先の、http(s)の絶対URLです。

Maximum string length: 512
expires_in_minutes
integer
デフォルト:60

任意。発行されるリンクの有効期間(分)です。SATOSHI_TESTが提示される場合は、Satoshiテストの期間をカバーするよう自動的に延長されます。

必須範囲: 5 <= x <= 10080

レスポンス

発行されたウィジェットセッションです。

widget_session_id
string<uuid>
token
string

ウィジェットURLに埋め込まれる不透明なセッショントークンです。

url
string

ホスト型ウォレット所有権ウィジェットのURLです。そのままの形でシステムブラウザで開いてください(モバイルSDKのWebView内では絶対に開かないでください)。

expires_at
string<date-time>
最終更新日 2026年11月1日