发起转账接口

商户业务系统可通过转账接口,实现各钱包账户余额互转。

接口说明

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

适用对象: 特约商户

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

请求方式:POST

请求类型:application/jsonapplication/x-www-form-urlencoded

请求参数

字段名 变量名 必填 类型 示例值 描述
商户号 mchNo String(30) M1621873433953 商户号
应用ID appId String(24) 60cc09bce4b0f1c0b83761c9 应用ID
商户订单号 mchOrderNo String(64) M16283883828 商户生成的订单号,需保证唯一
付款方钱包用户编号 payWalletId String(30) 12444260034 付款方钱包用户编号
收款方钱包用户编号 receiveWalletId String(30) 12444260012 收款方钱包用户编号
转账金额 amount long 30 转账金额, 单位:分
货币代码 currency String(3) cny 货币代码,固定cny
客户端IP地址 clientIp String(30) 127.0.0.1 客户端IP地址
渠道参数 channelExtra String(256) {“code”:”13920933111042”} 特定渠道发起的额外参数,json格式字符串,保留字段
扩展参数 extParam String(512) 134586944573118714 商户扩展参数,回调时会原样返回
请求时间 reqTime long 1622016572190 请求接口时间,13位时间戳
接口版本 version String(3) 1.0 接口版本号,固定:1.0
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名值,详见签名算法
签名类型 signType String(32) MD5 签名类型,目前只支持MD5方式

请求示例数据

{
    "amount": 1000,
    "mchOrderNo": "MT1700100666084",
    "payWalletId": "2",
    "appId": "64e87b640d1480cf86ae4385",
    "clientIp": "192.166.1.132",
    "sign": "A7A6F45C76A4D651EA68835E350DA133",
    "receiveWalletId": "6",
    "signType": "MD5",
    "currency": "cny",
    "reqTime": "1700100666",
    "mchNo": "M1692957540",
    "version": "1.0"
}

返回参数

字段名 变量名 必填 类型 示例值 描述
返回状态 code int 0 0-处理成功,其他-处理有误,详见错误码
返回信息 msg String 签名失败 具体错误原因,例如:签名失败、参数格式校验错误
签名信息 sign String CCD9083A6DAD9A2DA9F668C3D4517A84 对data内数据签名,如data为空则不返回
返回数据 data String {} 返回下单数据,json格式数据

data数据格式

字段名 变量名 必填 类型 示例值 描述
平台转账单号 transferId String T1724973335227740162 平台转账单号
商户订单号 mchOrderNo String MT1700096903554 商户订单号
转账金额 amount long 30 转账金额, 单位:分
转账状态 state int 2 转账状态: 0-订单生成, 1-转账中, 2-转账成功, 3-转账失败, 4-订单关闭
渠道转账单号 channelOrderNo String T7812873321y8192 渠道转账单号
渠道错误码 errCode String 100E0047 上游渠道返回的错误码
渠道错误描述 errMsg String 账户余额不足 上游渠道返回的错误描述

返回示例数据

{
    "code": 0,
    "data": {
        "amount": 100000000,
        "channelOrderNo": "",
        "errCode": "100E0047",
        "errMsg": "账户余额不足",
        "mchOrderNo": "MT1700100666084",
        "state": 3,
        "transferId": "T1724973335227740162"
    },
    "msg": "SUCCESS",
    "sign": "DD37B9800B2F3DAA6E2E653723B73B5D"
}

转账查询接口

商户通过该接口上送平台转账单号或商户订单号,查询转账状态。

接口说明

适用对象:特约商户

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

请求方式:POST

请求类型:application/jsonapplication/x-www-form-urlencoded

请求参数

字段名 变量名 必填 类型 示例值 描述
商户号 mchNo String(30) M1621873433953 商户号
应用ID appId String(24) 60cc09bce4b0f1c0b83761c9 应用ID
平台转账单号 transferId String(30) T1724973335227740162 平台转账单号,与mchOrderNo二者传一即可
商户订单号 mchOrderNo String(30) MT1699947028710 商户生成的订单号,与transferId二者传一即可
请求时间 reqTime long 1622016572190 请求接口时间,13位时间戳
接口版本 version String(3) 1.0 接口版本号,固定:1.0
签名 sign String(32) C380BEC2BFD727A4B6845133519F3AD6 签名值,详见签名算法
签名类型 signType String(32) MD5 签名类型,目前只支持MD5方式

请求示例数据

{
    "mchOrderNo": "MT1699945076448",
    "appId": "64e87b640d1480cf86ae4385",
    "sign": "72A58CB144C4C3C2461AFF1340D5F5B9",
    "signType": "MD5",
    "reqTime": "1700101010",
    "mchNo": "M1692957540",
    "version": "1.0"
}

响应参数

字段名 变量名 必填 类型 示例值 描述
返回状态 code int 0 0-处理成功,其他-处理有误,详见错误码
返回信息 msg String 签名失败 具体错误原因,例如:签名失败、参数格式校验错误
签名信息 sign String CCD9083A6DAD9A2DA9F668C3D4517A84 对data内数据签名,如data为空则不返回
返回数据 data String {} 返回下单数据,json格式数据

data数据格式

字段名 变量名 必填 类型 示例值 描述
平台转账单号 transferId String T1724973335227740162 平台转账单号
商户号 mchNo String M1621873433953 商户号
应用ID appId String 60cc09bce4b0f1c0b83761c9 应用ID
支付接口代码 ifCode String(30) hnawalletpay 支付接口代码
商户订单号 mchOrderNo String M16283883828 商户订单号
付款方钱包用户编号 payWalletId String 124442600 付款方钱包用户编号
收款方钱包用户编号 receiveWalletId String 124442622 收款方钱包用户编号
转账金额 amount long 30 转账金额, 单位:分
转账状态 state int 2 转账状态: 0-订单生成, 1-转账中, 2-转账成功, 3-转账失败, 4-订单关闭
渠道转账单号 channelOrderNo String T7812873321y8192 渠道转账单号,转账状态为2时返回
转账成功时间 successTime String 2023-11-01 10:02:25 转账成功时间,转账状态为2时返回
扩展参数 extParam String 134586944573118714 商户扩展参数,回调时会原样返回
备注 remark String 备注 备注
渠道错误码 errCode String 100E0047 渠道下单返回错误码
渠道错误描述 errMsg String 账户余额不足 渠道下单返回错误描述

返回示例数据

{
    "code": 0,
    "data": {
        "amount": 100000000,
        "appId": "64e87b640d1480cf86ae4385",
        "channelOrderNo": "",
        "errCode": "100E0047",
        "errMsg": "账户余额不足",
        "ifCode": "hnawalletpay",
        "mchNo": "M1692957540",
        "mchOrderNo": "MT1699945076448",
        "payWalletId": "2",
        "receiveWalletId": "6",
        "state": 3,
        "transferId": "T1724320746689642497"
    },
    "msg": "SUCCESS",
    "sign": "1177CB4D541354D67202C8838CF41D98"
}

返回码

code 描述
0 成功
9999 异常,具体错误详见msg字段
文档更新时间: 2024-04-30 10:44   作者:朱小