功能说明

请求将备付金账户中的资金代付至其他账户

接口HOST地址

取决于您原力支付服务部署所在的主机网络地址.
请注意确保防火墙设置已经允许通过该网络地址端口进行访问.
如果要修改此接口地址请通过<原力支付控制台>-<系统设置>进行设置

接口Action路径: /transfer

请求方法: GET方法

请求参数

MerchantID	必填,最大长度12,字符串格式,大小写敏感. 商户的标识,标识了该交易订单的所属商家. 更多商户标识可以在控制台<获得产品支付入口>中查看.
TransferNo	必填,最大长度18,字符串格式,大小写敏感 资金代付操作的唯一标识,可根据时间戳规则生成此标识并且保证此标识的唯一性. 例如:T20190429161256258
TransferMethod	必填,字符串格式 付款方的支付来源账户 ALP    --从备付金账户进行支付宝代付 WXP   --从备付金账户进行微信代付
TransferAmount	必填,浮点型,精确保留2位小数 代付的资金额度,人民币元为单位,如1.00元,最小代付额度为0.10
TransferDesc	必填,最大长度60,字符串格式, 代付的原因描述
TransferType	必填,代付的方式.字符串格式. LoginName   --通过微信号,支付宝登录账号进行代付 AccountID    --通过微信支付宝账户唯一标识进行代付, BankCard    --通过银行卡账号进行代付, 支付宝的唯一标识是2088开头的,微信的唯一标识是28位字符串
TransferBankName	选填,最大长度20,字符串格式. 收款方银行名称标识,仅TransferType=BankCard时必填,参见附录 银行卡标识
TransferBankType	选填,最大长度10,字符串格式. 收款方银行账号类型,仅TransferType=BankCard时必填, 设置GS为对公代付,设置GR为对私代付
TransferAccount	必填,最大长度50,字符串格式. 实际的收款方账户号,根据TransferType参数填写.
TransferRealName	必填,最大长度20,字符串格式 代付的收款方真实姓名
CheckRealName	必填,字符串格式. yes    --代付同时要求检查收款方真实姓名是否匹配 no     --无需真实姓名检查
TransferTimestamp	必填,最大长度18,字符串格式,大小写敏感 代付请求的时间戳,应通过当前时间进行生成,格式为YYYYMMDDHHMMSS 例如:20190429161256,支付系统会验证这个时间戳误差不能超出10分钟
TransferCustomParam	必填,最大长度500,字符串格式. 交易的自定义数据,您可以在这个参数中保存您的业务参数. 如果您设置了代付完成时使用HTTP联动通知,则此参数会在 HTTP联动通知回调中进行回传,请用URLENCODE对此参数编码, 否则可能会造成此参数的意外截断.
TransferSignMode	必填,字符串格式 此代付请求的签名模式,支持的签名模式有如下: MD5 --使用MD5进行简单签名 RSA_SHA256 --使用基于RSA非对称加密的SHA256签名算法,非常安全
TransferSignature	必填,字符串格式 此代付请求的数据安全签名,请根据安全签名格式说明进行计算设置

应答参数

通过JSON格式返回请求结果参数:
Result --指示了此次操作结果是否成功
ResultDesc--指示了此次操作结果详细说明

以下是请求成功返回的参数:
MerchantID --返回了代付操作对应的商户标识
TransferNo --返回了代付唯一标识
TransferToken --返回了代付的凭据
TransferResultDesc --返回了代付操作的结果描述

应答状态

成功返回200,失败返回对应错误码与错误描述

备注

为了保证资金安全,请求资金代付API接口需要对请求数据进行安全签名,安全签名可分为MD5,RSA_SHA256两种方式.
安全签名实现方法请参阅<安全签名算法说明>.您也可以直接使用ForcePaySDK来生成安全签名.

原力支付系统控制台可以开启或关闭资金代付API接口,可以指定该接口的验签算法以及限制调用的来源IP地址.
在使用RSA_SHA256进行安全签名时,会用到商户私钥数据,此私钥数据需要先从控制台进行导出.

附录

银行名称标识
Bank_GSYH,//工商银行
Bank_NYYH,//农业银行
Bank_ZGYH,//中国银行
Bank_JSYH,//建设银行
Bank_ZSYH,//招商银行
Bank_YCYH,//邮储银行
Bank_JTYH,//交通银行
Bank_PFYH,//浦发银行
Bank_MSYH,//民生银行
Bank_XYYH,//兴业银行
Bank_PAYH,//平安银行
Bank_ZXYH,//中信银行
Bank_HXYH,//华夏银行
Bank_GFYH,//广发银行
Bank_GDYH,//光大银行
Bank_BJYH,//北京银行
Bank_NBYH,//宁波银行
Bank_SHYH,//上海银行
Bank_OTHER,//其他银行