1、 代收付 2.0对接场景说明文档 版本 日期 拟稿和修改 说明 1.00 2016-11-6 孔坤 初稿 上海富友支付服务有限公司 2016/11/6 目录 一 .简介 1 1.业务模式 1 2.对接流程 1 3.系统功能 1 二 . 操作流程 2 2.1 签约 . 3 2.11 pos 签约 3 2.12 五要素签约 . 3 2.13 六要素签约 . 4 2.2 项目录入 . 5 2.3 代收 . 6 2.4 代付 . 6 2.5 对账文件获取 . 7 1 一 .简介 1.业务模式 代收付 2.0，是富友支付为商户提供的一套可以代收代付的系统； 代收（代扣）：通过接口 /平台直接从代收人银行
2、账户扣除，并清算到商户虚拟户； 代付：从商户虚拟户直付款到代付人银行卡； 支持范围：代扣支持中、农、工、建、招、浦发等多家银行，付款支持所有大陆的银行。具体代扣银行及额度，联系对接群运营，提供最新的限额表； 到账时间：代收付支持 T+0， T+1，入网时可配置，具体资费及配置申请同富友市场（商务）对接协调； 2.对接流程 测试环境：商户申请测试对接，即可由富友技术协调员发起，建立商户对接群，协调对接测试事宜、并提供相关测试材料； 生产环境：商户测试通过后，并已完成入网及资费配置等其它商务事宜后，在对接群向富友技术协调员申请上线，富友提供商户号、秘钥等相关材料，进行生产对接； 对接培训 ：联系富
3、友技术协调员发起； 3.系统功能 代收付 2.0 系统功能实现包括以下几个模块： 接口文档 功能：项目录入、代收、代付操作，以及交易查询、项目审核通、退票通知； 需要开发，接口类型为纯接口模式； 获取地址： https:/ 选择代收代付 -对接文档 2.0，可在网站上下载最新的接口文档及相关资料；或者在对接群联系富友技术协调员提供； 代收付平台 功能：单笔 /批量的项目录入、代收、代付、项目管理、交易查询、查询交易统计报表、账户管理（商户虚拟户充值提现）等； 登录权限分为：操作员、复核员，上述交易需要操作员发起操作，复核员复核，交易完成。账号密码地址入网后提供； 所有批量操作的文件，一个文件最
4、多包含 2000 条数据； 签约接口 代扣必须要签约成功，代付不需要签约；签约分为线上和线下两种； 线上：对接后，根据协议约定，由富友技术协调员提供相关的接口签约文档； 线下：线下签约方式为 pos 签约，联系富友市场（商务）提供 pos 机； 2 二 .操作流程 下图为代收付 2.0 业务流程简介； 关联付款： 先进行项目录入，然后进行代付； 代付成功，才可以进行代扣，两者的项目 id 和 业务定义必填，保持一致； 规则： 必须要有一笔 付款 才能做扣款 ，首日 代扣额度不超过 当天 付款累计值 70%； 累计代扣金额 付款金额 +付款金额 *利率 /365 天 *项目期限 天 数 +付款金
5、额 *手续费率 ； 利率默认最高（ 36.00%） 手续费 率默认最高（ 4.00%） ； 可调整，需 联系富友市场（商务）申请风控审核； 不关联付款： 代扣、代付分开，不关联规则； 代付：项目 id 和业务定义可空； 代扣：需先进行项目录入，生成项目 id； 累计代扣金额 项目本金 +项目本金 *利率 /365 天 *项目期限 天 数 +本金 *手续费率 ； 利率默认最高（ 36.00%） 手续费 率默认最高（ 4.00%） ； 可调整，需联系 富友市场（商务）申请风控审核 ； 3 2.1 签约 如上所述，代扣需先完成签约。富友提供签约接口文档，分为： 5 要素签约接口， 6 要素签约接口，
6、以及线下 pos 签约； 模式选择：线上 5 要素签约、六要素签约。由富友市场（商务）、风控对商户资格进行审核后，选择提供一种对应商户风控等级的签约类型； 线下 pos 签约为标配； 2.11 pos 签约 在富友提供的 pos 上，选择签约 ， 输入客户 姓名、卡号、证件类型、证件号 、 银行密码， 返回签约结果， 签字，打印 凭条 ， 签约完成； 2.12 五要素签约 根据富友提供的五要素接口文档，进行开发； 页面形式：调用接口后、跳转到富友的页面完成签约操作； 4 2.13 六要素签约 1. 调用富友提供的六要素签约接口，上传请求参数，详见接口文档； 2. 跳转富友页面（ web、 H5
7、），用户确定个人信息及银行预留手机号是否准确，勾选协议，点击确认； 3. 跳转银联签约页面（ P2），输入银行卡密码，点击获取验证码，提交验证，页面返回签约结果； 5 4. 商户提供异步回调地址（对接群富友技术协调员配置），异步通知签约结果，仅返回签约成功结果； 5. 签约失败，通过签约查询接口（富友提供）查询，请求参数具体看接口文档； 6. 签约用户必须开通银联在线业务，客户可以在银联签约界面获取签约失败原因； 开通 银联在线支付业务的银联官网地址： https:/ 点击页面 “立即在线开通 ”； 2.2 项目录入 在代收付 2.0 的接口代扣或者平台代扣中，项目 id 都是必填，所以要先进
8、行项目录入，生成项目 id； 商户通过接口（单笔）项目录入或者代收付平台进行项目录入（单笔 /批量，批量录入一个文件最多 2000 条数据），录入成功后，富友返回项目 id； 项目状态：默认为事后审核（可正常做交易）； 审核不通过：富友通过项目审核通知接口、通知商户项目审核状态，代扣不能发起；商户需根据审核通知，修改项目信息及附件内容。在代收付平台 -项目录入菜单， 可以查询已上传项目信息，未通过可 进行 修改，重新提交 ； 待审核：抽检后，项目状态变为待审核，不可做交易，项目补录入附件后，富友审核 通过，即可正常交易； 6 平台录入： 录入参数见平台，支持单笔 /批量录入； 附件（ 可不传
9、）： ， 商户借款 合同 （关键 页面 ） 、 委托 扣款协议、 借款人身份证 、银行卡 扫描件 ,上传 文件 格式 ： JPG、 PNG、 PDF； 命名规则：项目 ID_01 和 项目 ID_02，分 两个文件上传 ； 文件大小： 单个 不超过 10M； 补录入附件：代收付平台 -项目查询，找到该项目，进行补录入附件； 接口录入： 上传参数详见接口文档； 附件（ 可不传 ）：委托扣款协议、借款合同、借款人个人信息（银行卡、身份证），上传文件格式： JPG、 PNG、 PDF；命名规则：项目 ID_01 和项目 ID_02，分两个文件上传；文件大小：单个不超过 10M； 通过 ftp 上传，
10、 ftp 账号，由富友根据商户分配，在对接群申请； 项目审核通知接口 ：在对接群提供地址给富友技术协调员配置，即可收到项目审核通知的结果； 2.3 代收 代收，即商户发起，对已经签约成功的用户，直接从签约卡里扣款到平台虚拟户的交易。限额表联系对接群的技术协调员提供最新代扣支持银行及限额表； 代收方式支持 2 种： 通过接口（单笔）发起代收； 通过代收付平台发起单笔 /批量代收。需操作员发起，复核员复核； （项目 id 及业务定义必填） 2.4 代付 代付，即商户发起，从商户虚拟户余额，付款到用户银行卡的交易，限额为单笔 100W，单日无限额； 代付方式支持 2 种： 通过接口（单笔）发起代付；
11、 通过代收付平台发起单笔 /批量代付。需操作员发起，复核员复核； （关联项目 付款 ，项目 id 及业务定义必填） 退票通知 富友系统对账后，产生退票，主动通知商户； 地址配置：商户提供通知地址，在对接群申请配置，富友技术协调员协助完成配置； 7 2.5 对账文件获取 提供商户号， IP，向对接群技术协调员申请开通 FTP 服务器，进行 账文件配置 ； 开通后，富友技术协调员提供 FTP 地址和账号密码至商户； 配置成功后， T 日 10 点左右，提供之前清算周期的对账文件，商户登录获取对账文件，只有成功交易； 对账文件命名：商户号 mchntcd_Date.txt，例为 mchntcd_20150604.txt 内容： 业务代码 |交易来源 |交易流水号 |源交易流水号 |富友帐务流水号 |文件明细号 |交易提交时间 |商户复核时间 |交易发送时间 |交易类型 |文件名 |交易金额 |交易手续费 |户名 |扣款账号 |收款账号 |注释 |企业流水号 |备注 |手机号 业务代码 ： 手机快捷支付： PY36； B2C 支付： PY22；银行卡验证： PA20；代付： AP01；退票： TP01；代收： AC01；
