支付/预支付/充值

接口说明

支付/预支付/充值调用此接口

  • 支付:指的是先调用下单接口下单,拿到订单号后进行支付
  • 预支付:指的是未调用下单接口,进行预先支付金额

接口地址

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": "未知异常"
}
Copyright © 首约科技(北京)有限公司 2020 all right reserved,powered by Gitbook该文件修订时间: 2024-09-10 08:00:38

results matching ""

    No results matching ""