Onerway
POST

3DS 事件

回调地址
使用此 webhook 接收 3DS 一次性验证码事件。

回调报文字段

request_id
用于去重的唯一事件标识。
event_type
事件类型标识。
约束
取值
此 webhook 固定为 issuing.card3dsEvent。
created_at
事件创建时间,ISO 8601 格式。
version
创建 webhook 订阅时选择的 API 版本。
卡片 3DS 事件业务数据。

回调示例

{
  "request_id": "replace_with_event_id",
  "event_type": "issuing.card3dsEvent",
  "created_at": "2026-01-01T00:00:00Z",
  "version": "1.0",
  "data": {
    "cardId": "example_card_id",
    "txnOrderNo": "example_transaction_order",
    "type": "OTP",
    "card3dsValues": "123456",
    "description": "",
    "transactionTime": 1767225600000,
    "expireTime": 1767225900000,
    "currency": "USD",
    "amount": 125.5,
    "merchantName": "Example Merchant"
  }
}

应答说明

成功接收并受理 3DS 事件后返回 HTTP 200 和 respCode=20000;响应码不是 20000 时 Onerway 会重试。

应答正文示例

{
  "respCode": "20000",
  "respMsg": "success"
}