卡密就绪推送

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

9.3 卡密就绪推送

{
  "eventId": "order.credentials.ready:card-delivery:10001:30001",
  "eventType": "order.credentials.ready",
  "occurredAt": 1785216002,
  "clientOrderRef": "PO-20260728-0001",
  "platformOrderRef": "D202607290001",
  "orderState": "success",
  "card_list": [
    {
      "card_no": "CARD-NO-EXAMPLE",
      "card_password": "CARD-PASSWORD-EXAMPLE"
    }
  ]
}

字段

JSON 类型

必填

含义

eventId

string

是

本次消息编号；第三方按该编号防止重复保存卡密

eventType

string

是

固定为 order.credentials.ready

occurredAt

integer

是

卡密准备完成时间，10 位 Unix 秒级时间戳

clientOrderRef

string

是

第三方订单号

platformOrderRef

string

是

平台订单号

orderState

string

是

卡密就绪后的平台订单状态，正常为 success

card_list

object[]

是

本单已经准备完成的全部卡密

card_list[].card_no

string

是

卡号；没有单独卡号时为空字符串

card_list[].card_password

string

是

卡密或密码；没有单独密码时为空字符串

card_no 和 card_password 始终分开提供。没有单独卡号或密码时，对应字段返回空字符串。

  • 全部卡密准备完成并保存成功后，平台才发送 order.credentials.ready。

  • 卡密消息会优先立即发送。

  • 这条消息同时表示卡密订单已经交易成功，不会再发送一条 order.changed(success)。

  • 取消和充值订单不会发送该消息，普通状态变化由 order.changed 发送。

  • 没有收到 OK 时，平台会使用同一个 eventId 重试。第三方必须先保存卡密和 eventId，再返回 OK，避免重复发卡。

  • 三次发送都失败后，第三方可以通过 GET /orders/{clientOrderRef} 查询卡密。

上一篇下一篇