发起提现接口

商户业务系统可通过提现接口，将钱包余额提现到银行卡。

接口说明

提现成功判断说明：接口返回提现状态state=2为提现成功， state=1时需调用提现查询接口确认提现状态。接口返回code=0仅表示提现发起成功。

适用对象： 特约商户

请求URL：https://pay.jeepay.vip/api/wallet/cashout

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
    "walletId": "2",
    "amount": 1000,
    "extParam": "mchParams",
    "mchOrderNo": "MT1700096903554",
    "sign": "24DD7074B10D9C36B5FA6924FFF532C2",
    "remark": "备注",
    "reqTime": "1700096903",
    "version": "1.0",
    "appId": "64e87b640d1480cf86ae4385",
    "accountNo": "88888",
    "clientIp": "192.166.1.132",
    "notifyUrl": "http://192.168.0.168:9216",
    "signType": "MD5",
    "currency": "cny",
    "mchNo": "M1692957540"
}

返回参数

data数据格式

返回示例数据

{
    "code": 0,
    "data": {
        "amount": 1000,
        "cashoutId": "C1724957556453224449",
        "channelOrderNo": "",
        "errCode": "100E0047",
        "errMsg": "账户余额不足",
        "mchOrderNo": "MT1700096903554",
        "state": 3
    },
    "msg": "SUCCESS",
    "sign": "57CD0DECAC77D13F6DCE01F504A195CF"
}

提现查询接口

商户通过该接口上送提现单号或商户订单号，查询提现状态。

接口说明

适用对象：特约商户

请求URL：https://pay.jeepay.vip/api/wallet/cashout/query

请求方式：POST

请求类型：application/json 或 application/x-www-form-urlencoded

请求参数

请求示例数据

{
    "mchOrderNo": "MT1699947028710",
    "appId": "64e87b640d1480cf86ae4385",
    "sign": "43A3B21C14955AEA3A04467A85451D98",
    "signType": "MD5",
    "reqTime": "1700099741",
    "mchNo": "M1692957540",
    "version": "1.0"
}

响应参数

data数据格式

返回示例数据

{
    "code": 0,
    "data": {
        "amount": 1000,
        "appId": "64e87b640d1480cf86ae4385",
        "cashoutId": "C1724328933329321985",
        "channelOrderNo": "",
        "errCode": "100E0047",
        "errMsg": "账户余额不足",
        "extParam": "mchParams",
        "ifCode": "hnawalletpay",
        "mchNo": "M1692957540",
        "mchOrderNo": "MT1699947028710",
        "remark": "备注",
        "state": 3,
        "walletId": "2"
    },
    "msg": "SUCCESS",
    "sign": "099ECF5B1941F59A7319306F176CC5BA"
}

提现通知

当钱包提现成功时，平台网关会向商户系统发起回调通知。如果商户系统没有正确返回，平台网关会延迟再次通知。

接口说明

适用对象：特约商户

请求URL：该链接是通过发起提现接口提交的参数notifyUrl设置，如果无法访问链接，商户系统将无法接收通知。

请求方式：POST

请求类型：application/x-www-form-urlencoded

通知参数

返回结果

商户业务系统处理后同步返回给平台网关，返回字符串 success 则表示成功，返回非success则表示处理失败，支付中心会再次通知业务系统。（通知频率为0/30/60/90/120/150,单位：秒）

注意：返回的字符串必须是小写，且前后不能有空格和换行符。

通知示例数据

{
  "amount": 1000,
  "appId": "64e87b640d1480cf86ae4385",
  "cashoutId": "C1724328933329321985",
  "channelOrderNo": "",
  "errCode": "",
  "errMsg": "",
  "extParam": "mchParams",
  "ifCode": "hnawalletpay",
  "mchNo": "M1692957540",
  "mchOrderNo": "MT1699947028710",
  "remark": "备注",
  "state": 2,
  "walletId": "2",
  "reqTime": "1622016572190",
  "sign": "099ECF5B1941F59A7319306F176CC5BA"
}

返回码