汇潮支付有限公司.doc

汇潮支付有限公司 资金托管接口说明文档 版本：1.0  目 录 1 文档说明 3 1.1 功能描述 3 1.2 阅读对象 4 1.3 业务术语 4 2 接口开发 5 2.1 接口介绍 5 2.2 接入准备 6 2.3 返回处理实现流程 7 3 数据交互 8 3.1 页面跳转交互 8 3.2 服务器通知交互 8 4 数据格式 8 4.1 POST 8 5 数字签名 9 5.1 签名原始串 9 5.2 签名算法 9 5.2.1 MD5签名 9 6 补单机制 9 7 接口 10 7.1 开通专属账户接口 10 7.1.1 数据交互 10 7.1.2 请求参数列表 10 7.1.3 页面返回和服务器返回 11 7.2 资金托管充值接口 12 7.2.1 数据交互 12 7.2.2 请求参数列表 12 7.2.3 页面返回和服务器返回 13 7.3 资金托管交易接口 14 7.3.1 数据交互 14 7.3.2 安全签名 14 7.3.3 请求参数列表 15 7.3.4 签名描述 16 7.3.5 返回 16 7.4 资金托管提现接口 16 7.4.1 数据交互 16 7.4.2 安全签名 17 7.4.3 请求参数列表 17 7.4.4 签名描述 18 7.4.5 回调说明 18 7.4.6 银行列表 19 7.5 查询请求参数 21 7.5.1 充值、提现和交易的查询 21 7.5.2 返回参数说明 22 7.5.3 查询用户账户余额 24 7.5.4 返回参数说明 24 1 注意事项 25 文档说明 功能描述 本文描述了一麻袋提供给合作商户的资金托管解决方案，帮助商户轻松实现商户收益和商户资金池分离的功能。文档分别从交互模式、签名、接口、注意事项等方面详细介绍了一麻袋的接口连接方式和开发注意事项，可以帮助开发人员快速集成支付接口到网站中去。 阅读对象 合作商户系统的技术开发人员，要求具有WEB程序开发背景，了解http和https请求和应答的格式和过程，对XML格式有所掌握。 业务术语 术语 解释 防钓鱼 “网络钓鱼”攻击利用欺骗性的电子邮件和伪造的Web站点来进行诈骗活动，受骗者往往会泄露自己的财务数据，如信用卡号、账户用户名、口令和社保编号等内容，造成损失。防钓鱼用来防止以上情况的发生。 请求 通过HTTP协议把需要传输的数据发送给接收方的过程。 返回 得到的处理，，同时商户。 通知 服务器的服务器主动发起通知给商户的网站，同时携带处理完成的结果信息反馈给商户网站。 为保证通讯不被篡改，商户在一麻袋网站上获取的一组字符串，签名时使用 请求URL 功能说明 结果说明 开通一麻袋专属账户接口 /openAccount 调用该接口时传入约定参数，完成生成一麻袋专属账户的功能 页面返回，返回地址为请求时传递的return_url参数；参数，收到通知后进行响应。 充值接口 /hostingRecharge 在一麻袋充值页面选择银行后跳转到相应银行进行付款操作，操作成功后，钱会进入一麻袋相应的托管账户中，同时通知商户该笔订单完成 页面返回，返回地址为请求时传递的return_url参数；参数，收到通知后进行响应。 交易接口 /hostingTrade 调用该接口时传入约定参数，完成生成一麻袋托管账户交易转账的功能 实时返回交易状态码 提现接口 /hostingWithdrawcash 调用该接口时传入约定参数，完成生成一麻袋专属账户的钱到用户银行卡的操作 服务器返回，返回地址为请求时传递的adviceURL参数，收到通知后进行响应。 查询接口 /hostingTradeQuery 调用该接口时传入约定参数，根据查询条件返回商户充值 提现记录状态 返回标准的xml格式数据 接入准备 商户集成支付接口，需要先申请一个一麻袋的账户作为商户收款账户，然后将收款账户告诉相应的业务人员，一麻袋的工作人员会给该账户开通支付网关功能，设置交易手续费，结算周期等。商户注册成功以后会得到一个key，这是接口请求通知时需要参与数据签名的密钥请商户妥善管理。 返回处理实现流程 (1) 构造请求数据 商户根据一麻袋提供的接口规则，通过程序生成得到签名结果及要传输给一麻袋的数据集合。 (2) 发送请求数据 把构造完成的数据集合，通过页面链接跳转或表单提交的方式传递给一麻袋。 (3) 一麻袋对请求数据进行处理 一麻袋得到这些集合后，会先进行安全校验等验证，一系列验证通过后便会处理这次发送过来的数据请求。 (4) 返回处理的结果数据 对于处理完成的交易，一麻袋会以种方式把数据反馈给商户网站。 ，页面上通过自动跳转的方式跳回商户在请求时设定好的页面路径地址（参数eturn_url，如果商户没有设定，则不会进行