StripeStripe Identity 身份验证 API
POST/v1/identity/verification_sessions
创建验证会话
<p>创建 VerificationSession 对象。</p> <p>创建 VerificationSession 后,请使用会话的 <code>client_secret</code> 显示验证弹窗,或将用户跳转到会话的 <code>url</code>。</p> <p>如果 API Key 处于测试模式,验证检查不会真正处理,但其他流程会按实时模式执行。</p> <p>相关指南:<a href="https://docs.stripe.com/identity/verify-identity-documents">验证用户的身份证件</a></p>
创建、查询、更新、取消和编辑 Stripe Identity 验证会话,并查询验证报告;覆盖官方 Identity 路径下全部 8 个 Endpoint,Hub 仅提供文档与本地 SDK/CLI。
请求
- operationId
postIdentityVerificationSessions- 服务器
https://api.stripe.com- 认证
- bearerAuth
请求参数
无 URL、查询或 Header 参数。
Body 参数
object
Content-Type: application/x-www-form-urlencoded
字段: client_reference_idexpandmetadataoptionsprovided_detailsrelated_customerrelated_customer_accountrelated_personreturn_urltypeverification_flow
{
"expand": [
{}
],
"metadata": {},
"options": {},
"provided_details": {},
"related_person": {}
}响应
200
stripe_identity_verification_sessionapplication/json
请求成功。
字段: client_reference_idclient_secretcreatedidlast_errorlast_verification_reportlivemodemetadataobjectoptionsprovided_detailsredactionrelated_customerrelated_customer_accountrelated_personstatustypeurlverification_flowverified_outputs
default
stripe_errorapplication/json
错误响应。
字段: error
{
"created": 0,
"livemode": false,
"metadata": {}
}