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 参考
创建 Step-Up 认证 | Didit 认证 API
POST /step-up/ 在敏感操作前应用您的 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
}认证功能是新推出的。这些端点由您应用的签发方提供,例如
https://<name>.auth.didit.me,并且绝不接受您的 Didit API 密钥。return_to 上的 step_up 和 status 查询参数只是提示您的应用去查看。在采取任何操作之前,请使用 获取升级验证 读取该升级验证,并且仅当 status 为 approved 时才继续。授权
来自 POST /token/ 的该人员访问 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 必需:金额,最多两位小数。也接受 JSON 数字。
Pattern:
^[0-9]{1,16}(\.[0-9]{1,2})?$示例:
"900.00"
amount 的 ISO 4217 代码。默认为出款规则的币种;使用其他币种的出款始终会受到检查。
Pattern:
^[A-Z]{3}$示例:
"USD"
响应
没有适用的规则。
没有适用的规则:继续执行操作。
可用选项:
false 最后修改于 2026年11月7日