# 合同事件处理-真实货币交易事件

# 调用方式: 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

# 返回说明:

返回值字段 字段类型 字段说明
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