post https://dev.funpayvip.com/rest/cash-in/payment/query/v3
轮询接口是商户主动去查询某个订单的结果,一般情况下轮询接口是作为回调通知的辅助手段,以回调通知为准。因为轮询是一种由商户发起的不可控制的,IO密集型请求,所以我们对轮询接口进行了限流。具体的限流策略是动态变化的,文档里无法给出
轮询接口为了满足各种复杂情况,提供了非常复杂的数据结构,对于不感兴趣的数据,商户可以忽略。一般情况下只需要关注第一层数据就可以了
响应data
参数 | 类型 | 描述 |
---|---|---|
referenceId | string | 商户传过来的流水号 |
amount | long | 订单金额 |
receivedAmount | long | 累计收到的付款金额。在极端情况下,会存在多笔付款的情况 |
status | string | 订单状态 |
orders | array | 付款订单列表 |
orders
transactions
字段 | 类型 | 描述 |
---|---|---|
transactionId | string | 交易编号 |
receivedAmount | long | 付款金额 |
completeTime | string | 付款时间 yyyy-MM-dd hh24:mi:ss |
为什么会有多个order?
用户可以在收银台重新选择付款方式,就会生成一笔新的平台订单order。比如用户打开收银台,选择了BCA付款,生成了一个order,然后他觉得BCA不合适,又选择了DANA付款,又生成了一个order。这样就会存在2个order了
为什么会有多个transaction?
极端情况下,用户针对同一个VA多次付款。比如用户选择了BCA付款,非常短的时间内连续付款2次,就会在一个bca的order下生成多个transaction