提交验证码

API文档最后更新: 2026-08-31

仅当 allowedActions 包含 provideOtp 时可调用。

{
  "otp": "123456"
}

请求字段：

字段	位置	JSON 类型	必填	含义
`clientOrderRef`	Path	string	是	创建订单时提交的第三方订单号
`otp`	Body	string	是	订单处理所需的验证码，1 至 32 个字符

返回字段：

字段	JSON 类型	必填	含义
`code`	integer	是	固定为 `0`，表示请求成功
`message`	string	是	本次请求的处理说明
`data`	object	是	提交结果
`data.submitted`	boolean	是	`true` 表示验证码已提交成功
`requestId`	string	是	本次请求编号，排查问题时提供给平台

返回示例：

{
  "code": 0,
  "message": "success",
  "data": {
    "submitted": true
  },
  "requestId": "req_01K0EXAMPLE"
}

同一订单的提交频率受严格限制。失败时按 Retry-After 等待，不得持续轮询或高频重试。