撮合线下支付

1.撮合线下支付接口只支持撮合模式企业使用

接口名称：/trade/payOffline

请求参数

序号	层级	英文名称	中文名称	类型	长度	是否必填	说明
1	1	transportBillNumber	运单号	String	20	是	长度20
2	1	payerIdCard	付款方身份	String	50	否	社会统一信用代码
3	1	payerBankCardNumber	付款银行卡号	String	50	是
4	1	payerBankCode	付款银行代码	String	50	是	交通部银行编码(非银行转账方式付款时，该值传9999)
5	1	totalCost	支付总金额	Long	20	是	整数长度8，支付给承运人的金额，货币单位为人民币（分）
6	1	payPlans	支付计划明细	List<PayPlan>		是
7	2	payType	支付计划类型	Integer	5	是	20200-预付 20300-到付 20400-回单付 仅支持一起支付，不支持单笔支付
8	2	payTransactionNo	支付流水号	String	50	是	长度50位的字母和数字
9	2	payCost	支付金额	Long	20	是	整数长度8，支付给承运人的金额，货币单位为人民币（分）
10	2	payTime	支付时间	Long	13	是	毫秒时间戳
11	2	receiptDownloadUrlList	线下支付凭证	List<String>	255	条件必传	最大支持上传9张,平台开启'线下支付,支付回单必传'时需要传入

mock示例

{
    "transportBillNumber": "",
    "payerIdCard": "",
    "payerBankCardNumber": "",
    "payerBankCode": "",
    "totalCost": 10000,
    "payPlans": [
        {
            "payCost": 5000,
            "payTime": 1710838230000,
            "payTransactionNo": "",
            "payType": 20300,
            "receiptDownloadUrlList": [""]
        },
        {
            "payCost": 5000,
            "payTime": 1710838230000,
            "payTransactionNo": "",
            "payType": 20400,
            "receiptDownloadUrlList": [""]
        }
    ]
}

返回参数

成功OR失败

mock 数据示例

{
        "code": "00000",
        "data": true,
        "message": "请求成功"
 }

支付单查询

查询支付完成时间在起始时间和结束时间范围内的支付单（最大查询范围为90天）

接口名称：/trade/queryPayDetailsByTime

请求参数

序号	层级	英文名称	中文名称	类型	长度	是否必填	说明
1	1	payDateStartTime	支付完成的起始时间	Long		是	时间毫秒
2	1	payDateEndTime	支付完成的结束时间	Long		是	时间毫秒

返回结果：

序号	英文名称	中文名称	类型	说明
1	transportBillNumber	运单号	String
2	payFinishTime	支付完成时间	Long	时间毫秒
3	transactionNo	交易流水号	String
4	state	支付状态	Integer	0-待支付 1-成功 2-失败 3-支付中
5	payType	支付类型	Integer	20100-油卡付 20200-预付 20300-到付 20400-回单付 20500-信息费
6	payCost	支付金额	Long	单位为“分”
7	returnMsg	支付结果	String
8	orderNo	订单号	String	支付单唯一标识
9	carrierReceiptDownloadUrl	承运人收款回单	String	可能为空
10	transportCost	承运人运费	Long	单位为“分”

mock数据示例

{
    "code": "00000",
    "data": [
        {
            "transportBillNumber": "202203070004000002",
            "payFinishTime": 1646703919000,
            "transactionNo": "22030810452644201690943840002",
            "state": 1,
            "payType": 20200,
            "payCost": 22200,
            "returnMsg": null,
            "orderNo": "4-202203070004000002-20200",
            "carrierReceiptDownloadUrl": "https://oss.dev.xiaokuaikeji.com/esign_ceres/xxx.pdf",
            "transportCost": 99900
        },
        {
            "transportBillNumber": "202205240004000003",
            "payFinishTime": 1653371363000,
            "transactionNo": "22052413583923801690943960001",
            "state": 1,
            "payType": 20300,
            "payCost": 3300,
            "returnMsg": null,
            "orderNo": "4-202205240004000003-20300",
            "carrierReceiptDownloadUrl": null,
            "transportCost": 10000
        }
    ],
    "message": "请求成功",
    "traceId": "d590228135774d87b6e2bf247a01020d"
}