触发交易清算
POST https://api.4pyun.com/gate/1.0/payment/trade/settle
请求参数
字段名称 | 字段说明 | 类型 | 必填 | 示例 |
---|---|---|---|---|
app_id | P云平台分配的接入应用ID | string | Y | op1234567723122 |
pay_serial | P云支付流水(交易预请求返回) | string | Y | 20240614175507066020110395 |
settle_value | 实际清算金额,分,需<=实际交易金额 | int | Y | 1 |
sharding_value | 订单可分账金额,分(传递实际清算金额即可) | int | Y | 1 |
trade_item | 交易事项, 适用于部分例如充电项目区分服务费和电费, 传递JSON字符串 | string | N | [{"key":"energy_value","value":2103},{"key":"service_value","value":100}] |
reason | 清算原因说明 | string | Y | 充电结束退款剩余金额 |
sign | 签名 | string | Y | C65FCAC2D3FB5E2D3D4AD93DD20C8C39 |
返回参数
字段名称 | 字段说明 | 类型 | 必填 | 备注 |
---|---|---|---|---|
code | 状态码 | string | Y | 1001-下单成功 1403-支付订单号已存在 其它-读取message |
message | 返回描述 | string | N | 返回描述 |
hint | 返回错误说明 | string | N | 返回具体错描述指导 |
seqno | 服务器日志标示 | string | Y | 查日志用到查问题尽量提供这个值 |
状态码
值 | 描述 |
---|---|
1001 | 成功 |
1403 | 不可清算,参考message |
其它 | 参考message |