一麻袋资金托管API V1.0

B2C在线支付说明文档第1页共26页汇潮支付有限公司资金托管接口说明文档版本：1.0B2C在线支付说明文档第2页共26页目录1文档说明..........................................................31.1功能描述...........................................................................31.2阅读对象...........................................................................41.3业务术语...........................................................................42接口开发..........................................................52.1接口介绍...........................................................................52.2接入准备...........................................................................62.3返回处理实现流程...................................................................73数据交互..........................................................83.1页面跳转交互.......................................................................83.2服务器通知交互.....................................................................84数据格式..........................................................84.1POST...............................................................................85数字签名..........................................................95.1签名原始串.........................................................................95.2签名算法...........................................................................95.2.1MD5签名......................................................................96补单机制..........................................................97接口.............................................................107.1开通专属账户接口..................................................................107.1.1数据交互....................................................................107.1.2请求参数列表................................................................107.1.3页面返回和服务器返回........................................................117.2资金托管充值接口..................................................................12B2C在线支付说明文档第3页共26页7.2.1数据交互....................................................................127.2.2请求参数列表................................................................127.2.3页面返回和服务器返回........................................................137.3资金托管交易接口..................................................................147.3.1数据交互....................................................................147.3.2安全签名....................................................................147.3.3请求参数列表................................................................157.3.4签名描述....................................................................167.3.5返回........................................................................167.4资金托管提现接口..................................................................177.4.1数据交互....................................................................177.4.2安全签名....................................................................177.4.3请求参数列表................................................................177.4.4签名描述....................................................................187.4.5回调说明....................................................................197.4.6银行列表....................................................................207.5查询请求参数......................................................................227.5.1充值、提现和交易的查询......................................................227.5.2返回参数说明................................................................227.5.3查询用户账户余额............................................................247.5.4返回参数说明................................................................251注意事项.........................................................261文档说明1.1功能描述本文描述了一麻袋提供给合作商户的资金托管解决方案，帮助商户轻松实现商户收益和商户资金池分离的功能。文档分别从交互模式、签名、接口、注意事项等方面详细介绍了一麻袋的接口连接方式和开发注意事项，B2C在线支付说明文档第4页共26页可以帮助开发人员快速集成支付接口到网站中去。1.2阅读对象合作商户系统的技术开发人员，要求具有WEB程序开发背景，了解http和https请求和应答的格式和过程，对XML格式有所掌握。1.3业务术语术语解释防钓鱼“网络钓鱼”攻击利用欺骗性的电子邮件和伪造的Web站点来进行诈骗活动，受骗者往往会泄露自己的财务数据，如信用卡号、账户用户名、口令和社保编号等内容，造成损失。防钓鱼用来防止以上情况的发生。商户数字账号在一麻袋申请注册以后生成的一个7位数字账号，由注册时候得来请求通过HTTP协议把需要传输的数据发送给接收方的过程。返回页面交互，商户订单请求支付完成后，一麻袋会将得到的处理结果参数，传递到商户提供的return_url地址上，同时从一麻袋支付成功页面跳转到商户提供的接收结果页面上。页面交互不作为修改商户订单状态的依据通知服务器交互，商户订单请求支付完成后，一麻袋的服务器会主动发起通知给商户的网站，传递到商户提供的advice_url地址上同时携带处理完成的结果信息反馈给商户网站。密钥为保证通讯不被篡改，商户在一麻袋网站上获取的一组字符串，生成签名的时侯使用B2C在线支付说明文档第5页共26页2接口开发2.1接口介绍接口名请求URL功能说明结果说明开通一麻袋专属账户接口调用该接口时传入约定参数，完成生成一麻袋专属账户的功能页面返回，返回地址为请求时传递的return_url参数；服务器返回，返回地址为请求时传递的advice_url参数，要求收到通知后进行响应。充值接口在一麻袋充值页面选择银行后跳转到相应银行进行付款操作，操作成功后，钱会进入一麻袋相应的托管账户中，同时通知商户该笔订单完成页面返回，返回地址为请求时传递的return_url参数；服务器返回，返回地址为请求时传递的advice_url参数，要求收到通知后进行响应。注意：只返回成功结果，充值取消不返回结果交易接口调用该接口时传入约定参数，完成生成一麻袋托管账户交易转账的功能实时返回交易状态码B2C在线支付说明文档第6页共26页提现接口调用该接口时传入约定参数，完成生成一麻袋专属账户的钱到用户银行卡的操作服务器返回，返回地址为请求时传递的adviceURL参数，要求收到通知后进行响应。提现接口只返回失败操作，成功不给予返回查询接口调用该接口时传入约定参数，根据查询条件返回商户充值提现记录状态返回标准的xml格式数据2.2接入准备商户集成支付接口，需要先申请一个一麻袋的账户作为商户收款账户，然后将收款账户告诉相应的业务人员，