# 合同事件处理-真实货币交易事件
# 调用方式: POST
# 接口地址:
https://api.freelog.com/v2/contracts/{contractId}/events/prePayment
1
# url传入参数说明:
| 参数 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
| contractId | 必选 | string | 合约ID |
# body传入参数说明:
| 参数 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
| eventId | 必选 | string | 事件ID |
| tradeType | 必选 | string | 交易渠道 微信公众号:T_JSAPI 微信小程序:T_MINIAPP 支付宝JS:A_JSAPI 支付宝正扫:A_NATIVE |
| transactionAmount | 必选 | number | 付款金额,最多保留两位小数 |
| paymentChannelUserId | 必选 | string | 实际支付方渠道标识ID; 例如微信的openId |
| outOrderId | 必选 | string | 外部订单ID;每次支付都需要唯一,推荐uuid; 扫码前生成放入二维码中;PC端可以通过此订单ID查询交易状态; 例如判定是否已扫码,是否支付成功; |
# body示例
{
"eventId": "a2da448a",
"tradeType": "T_JSAPI",
"transactionAmount": 0.19,
"paymentChannelUserId":"oDQXL6rTxmZMTaLJVhF6InTJG0j8",
"outOrderId":"20420eb5ea93ce486e071852c6966afa"
}
1
2
3
4
5
6
7
2
3
4
5
6
7
# 返回说明:
| 返回值字段 | 字段类型 | 字段说明 |
|---|---|---|
| id | string | 支付记录ID |
| payInfo | string | json字符串;用于唤起微信原生支付界面 |
| qrCode | string | 原生交易时,需要生成支付二维码,例如支付宝的支付二维码 |
| paymentExpireDate | date | 支付超时时间 |
| description | string | 支付描述 |
# 返回示例
{
"ret": 0,
"errCode": 0,
"msg": "success",
"data": {
"id": "791145207960215552",
"payInfo": "{\"appId\":\"wx5179c4b6bbe0cc55\",\"timeStamp\":\"1765444872\",\"nonceStr\":\"4a064b5b0f0d4587abedeadf9f1def72\",\"package\":\"prepay_id=wx1117211266894891d9a4f167904f400000\",\"signType\":\"RSA\",\"paySign\":\"SM++a/jPmOLvmm135jBVNNwDuxbZVCsj03O5ibMKDakweV90l/LqUKXN7a/NstKA5Duu/h4hQbar5pb2Jb9bRzE7QGLNBVaFV6tSp2jFctsqKfKLNNyzGKv/QSWutGr77Dl0sraOlu053gwIBxLNVN5LPLJA4rU+hXrm9RXXT3B7KwckX43G9jj9ygWlR+w9P7x/zZ6MpspqDTmSsG+lk3pN2lOh65fIqYFHPEvCnr3mCzC9msAMs//ev0rwUoQYtH3ln3pozrpDKfT5Y3Wak3tipmwM2qWuSKk90CcBoAFw7k74G6CDaLWtdGsx+CU1ZnJnu8ZZ74Q7/DlzJRYteg==\"}",
"qrCode": "",
"paymentExpireDate": "2025-12-11T09:26:12.011Z",
"description": "资源-yuliang/七里香-永久解锁"
}
}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12