支付/预支付/充值
接口说明
支付/预支付/充值调用此接口
- 支付:指的是先调用下单接口下单,拿到订单号后进行支付
- 预支付:指的是未调用下单接口,进行预先支付金额
接口地址
https:// <SQYC_DOMAIN>/carapi/partner/umetrip/payOrder
请求方式
POST
请求参数
名称 | 类型 | 是否必选 | 说明 |
---|---|---|---|
channel | String | yes | 渠道名称,由首汽提供 |
partnerOrderNo | String | no | 合作方订单号 |
orderNo | String | no | 订单号 |
operateType | Integer | yes | 操作类型,0支付,1充值;2退款;3:预付定金 |
payType | Integer | yes | 支付方式(1.机构的账户余额支付,3.支付宝,4微信) |
paySubType | Integer | yes | 子支付方式,5:支付宝APP,6:微信APP,36:微信扫码,37:支付宝扫码,38:微信公众号支付,41:微信小程序,18:微信H5支付,7:支付宝H5支付,如果payType为3,改值默认为5,如果payType为4,则该值默认为6 |
payAmt | BigDecimal(20,2) | yes | 支付金额(单位:元) |
currency | Integer | no | 币种:0-CNY,1-HKD,默认0 |
payUserPhone | String | no | 用户手机号码(充值、预付费时必传) |
tradeOrderNo | String | yes | 商户订单流水号(支付时必传,传下单时的订单号) |
productName | String | yes | 商品名称 |
inputCharset | String | no | 字符编码,默认UTF8 |
clientIp | String | yes | 客户端IP |
longitude | String | no | 经度 |
latitude | String | no | 维度 |
cityId | String | no | 城市ID |
operator | String | no | 操作人,格式:操作人ID:操作人名称 |
openId | String | no | 微信openId,当支付方式为微信公众号或小程序时必传 |
merchantKind | Integer | no | 商户类型,1:首汽约车(默认),2:首付通,3:首汽约车需要使用首付通公众号支付,4:充值走消费退款,5:乐视TV,6:青岛交运,7:首汽专车,8:首汽大巴,11:航旅纵横 |
sign | String | yes | 请求签名,根据签名生成规则计算 |
返回参数
名称 | 类型 | 说明 |
---|---|---|
result | Integer | 0:成功;非0:失败原因编号 |
errmsg | String | 失败原因描述,若成功则值为空 |
data | Map<String,Object> | 成功返回,见下面data内容 |
data内容
名称 | 类型 | 说明 |
---|---|---|
payStatus | String | 支付状态(0-支付失败,1-支付成功,2-受理成功,3-等待付款) |
bankOrderNo | String | 商户订单号 |
tradeOrderNo | String | 业务订单号 |
payAmt | BigDecimal(20, 2) | 支付金额(单位:元) |
payOrderNo | String | 关联单号 |
返回示例
{
"result": 0,
"errmsg": "SUCCESS",
"data": {
"payStatus": "1",
"bankOrderNo": "1234567890",
"tradeOrderNo": "1234567890",
"serverDate": "2018-03-11 12:23:45",
"payAmt": 100,
"payOrderNo": "1111111111111111",
"wxMap": {
"mwebUrl": "http://www.01zhuanche.com/pay/result",
"prepayid": "asuore23UOwwEx2sdPOswea;",
"appid": "123asf23as",
"noncestr": "sajlwoer23490ajlsfas",
"package": "WXPay",
"partnerid": "sfa",
"timestamp": "2018-05-02",
"sign": "aewrILWsa232s",
"codeURL": "www.baidu.com"
},
"aliMap": {
"aliPayOrderNo": "C2343459045",
"mwebUrl": "http://www.01zhuanche.com/pay/result",
"callBackUrl": "http://www.01zhuanche.com/alipay/callback",
"name": "首汽约车",
"title": "首汽约车",
"orderString": "aewrILWsa232s",
"codeURL": "www.baidu.com"
},
"unionMap": {
"bankOrderNo": "234834540568734",
"tnCode": "ASEFsa823afsWEa92SDfw23ssd"
},
"appleMap": {
"tnCode": "ASEFsa823afsWEa92SDfw23ssd"
},
"cmbchinaMap": {
"appPayPrefix": "cmbmobilebank://CMBLS/FunctionJump?action=gofuncid&funcid=200007&serverid=CMBEUserPay&requesttype=post&cmb_app_trans_parms_start=here&",
"jsonRequestData": "{sign=4871a237de5206b8d48484b6356d0c0b615c6d387058e45d47993efa80dcad95, signType=SHA-256, reqData={returnUrl=null, amount=10, orderNo=20180814174418736001200534123, payNoticeUrl=https://test-paynotify.01zhuanche.com/sdk/pay/notify/cmbchina/42, dateTime=20180814174418, expireTimeSpan=15, merchantNo=000449, date=20180814, branchNo=0010, clientIP=192.168.29.20}, version=1.0}"
},
/*****************如下为京东H5支付相关***************************/
"jdMap": {
"successCallbackUrl": "m6sEvUSIgUSM9wN4yKBRMyFvW6c879lYRI+H7XVCYw4=\n",
"tradeDescription": "dVooTTt72+YUVkTrv5sPEwpaUXo3Kdql\n",
"tradeTime": "EfzNNJfx6dkHazvGp4XBa2RtCKToqGJv\n",
"tradeNum": "Ep+mWowNwCGJZWTCdrFI5MRA3q7SowHjkoUlKSzylyY=\n",
"tradeName": "首汽约车充值",
"type": "android",
"merchantRemark": "dVooTTt72+YUVkTrv5sPEwpaUXo3Kdql\n",
"encodeTradeName": "dVooTTt72+YUVkTrv5sPEwpaUXo3Kdql\n",
"version": "2.0",
"currency": "DhHzkZgqUQo=\n",
"merchantSign": "tX7SF83yvY1zLVGyndTJTp91Qox65adM1ZNBtGtkRVF64Pb9tj6ZrUiUtaAk20MDqKtoC/xN5Kb+\nccFidrnR4SPt+jhzh6o4Qpe2jRbd+qxzV2cWeH9GSVZNNSYLAVNKpMMuXgTUHkUyZk2Z5Few6pIQ\nUbSsxLxgWnDePTMKgdo=\n",
"tradeAmount": "ZB8nHpKfYHY=\n",
"notifyUrl": "m6sEvUSIgUSM9wN4yKBRMzYTdR/TH0TZw6zOdWavE6M=\n",
"failCallbackUrl": "m6sEvUSIgUSM9wN4yKBRMzciUWPRWF7nJ7EPkz9ZDhI=\n",
"serverUrl": "https://m.jdpay.com/wepay/web/pay",
"merchantNum": "110165974001"
}
/**************如下为京东app(sdk)支付***********************/
"jdMap": {
"orderId": "1045152328225099505638",
"signData": "a2f92adb590aea0c7fd1a6d2af34af14"
}
}
}
失败示例
{
"result": 1,
"errmsg": "未知异常"
}