触发交易清算
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 |