メインコンテンツへスキップ
POST
Authenticationは新機能です。これらのエンドポイントはアプリケーションのissuer(https://<name>.auth.didit.meなど)から提供され、Didit APIキーは一切受け付けません。
return_toに付与されるstep_upおよびstatusクエリパラメーターは、アプリケーションに確認を促すためのものにすぎません。処理を行う前にステップアップの取得でステップアップを読み取り、statusがapprovedの場合にのみ処理を続行してください。

承認

Authorization
string
header
必須

POST /token/から取得したこの人物のアクセストークンです。ヘッダーがtyp: at+jwtのES256 JWTで、有効期間は最長5分です。DiditのAPIキーではありません。

ボディ

application/json

対象者がこれから実行しようとしている機密性の高いアクションです。

action
enum<string>
必須

payout(出金または送金)、bank(銀行口座の追加または変更)、またはcontact(メールアドレスまたは電話番号の変更)です。出金・送金では、新しいデバイスに関するルールも適用されます。

利用可能なオプション:
payout,
bank,
contact
return_to
string
必須

本人が検証後に戻る先で、step_up=<id>&status=approvedが付加されます。ルールが適用される場合は、アプリケーションのリダイレクトURIのいずれかである必要があります。適用されるルールがない場合はチェックされません。

Maximum string length: 2048
例:

"https://app.example.com/payouts/confirm"

amount
string

payoutでは必須:金額(小数点以下2桁まで)。JSONの数値も受け付けます。

Pattern: ^[0-9]{1,16}(\.[0-9]{1,2})?$
例:

"900.00"

currency
string

amountのISO 4217通貨コード。デフォルトは支払いルールの通貨です。別の通貨での支払いは常にチェックされます。

Pattern: ^[A-Z]{3}$
例:

"USD"

レスポンス

適用されるルールはありません。

適用されるルールはありません。アクションを続行してください。

required
enum<boolean>
必須
利用可能なオプション:
false
最終更新日 2026年11月1日