curl --request POST \
--url https://{issuer}/step-up/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"action": "payout",
"amount": "900.00",
"currency": "USD",
"return_to": "https://app.example.com/payouts/confirm"
}
'
{
"required": false
}
APIリファレンス
ステップアップ認証の作成 | Didit Authentication API
DiditのPOST /step-up/は、機密性の高いアクションの前にステップアップルールを適用し、required falseまたは本人向けの認証URLを返します。
POST
/
step-up
/
curl --request POST \
--url https://{issuer}/step-up/ \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"action": "payout",
"amount": "900.00",
"currency": "USD",
"return_to": "https://app.example.com/payouts/confirm"
}
'
{
"required": false
}
Authenticationは新機能です。これらのエンドポイントはアプリケーションのissuer(
https://<name>.auth.didit.meなど)から提供され、Didit APIキーは一切受け付けません。return_toに付与されるstep_upおよびstatusクエリパラメーターは、アプリケーションに確認を促すためのものにすぎません。処理を行う前にステップアップの取得でステップアップを読み取り、statusがapprovedの場合にのみ処理を続行してください。承認
POST /token/から取得したこの人物のアクセストークンです。ヘッダーがtyp: at+jwtのES256 JWTで、有効期間は最長5分です。DiditのAPIキーではありません。
ボディ
application/json
対象者がこれから実行しようとしている機密性の高いアクションです。
payout(出金または送金)、bank(銀行口座の追加または変更)、またはcontact(メールアドレスまたは電話番号の変更)です。出金・送金では、新しいデバイスに関するルールも適用されます。
利用可能なオプション:
payout, bank, contact 本人が検証後に戻る先で、step_up=<id>&status=approvedが付加されます。ルールが適用される場合は、アプリケーションのリダイレクトURIのいずれかである必要があります。適用されるルールがない場合はチェックされません。
Maximum string length:
2048例:
"https://app.example.com/payouts/confirm"
payoutでは必須:金額(小数点以下2桁まで)。JSONの数値も受け付けます。
Pattern:
^[0-9]{1,16}(\.[0-9]{1,2})?$例:
"900.00"
amountのISO 4217通貨コード。デフォルトは支払いルールの通貨です。別の通貨での支払いは常にチェックされます。
Pattern:
^[A-Z]{3}$例:
"USD"
レスポンス
適用されるルールはありません。
適用されるルールはありません。アクションを続行してください。
利用可能なオプション:
false 最終更新日 2026年11月1日