提交会话已完成的资金流转交易
POST/transaction/push
为一个 k-ID 会话提交一个或多个已完成的购买。每个事件记录了购买了什么、花费多少,以及扣款是否成功。在购买完成后使用此端点,包括周期性购买的每次续费。
对于已尝试但未完成的扣款,请将 status 设为 failed,以便父母能区分两者。
事件会被独立处理。响应中包含每个事件的状态:
accepted- 购买已记录。重新提交id已被接受的事件是安全的无操作:它会再次计为accepted且不会重复记录,因此网络故障后的重试不会重复计数。rejected- 购买未通过校验;reason指明是哪条规则。
当会话不存在或已被吊销时,整个批次都会被拒绝。
Request
Responses
- 200
- 400
批次已处理。每个事件的状态表示是否被接受。
无效请求。响应正文的 error 字段包含具体的代码(例如 INVALID_INPUT、NOT_FOUND、FEATURE_DISABLED)。