1.产品介绍#
1.1简介#
财智码是指商家识别用户付款介质(如:条形码、二维码)进行收款或用户识别商家收款介质进行付款的一种支付产品,主要适用于线下场所面对面收银的场景,例如:便利店、商超综合体、餐饮、医院、学校、电影院、旅游景区等具有明确经营地址的实体场所。1.2应用场景#
付款码支付(商家扫用户付款码)#
商家使用扫码枪或其它扫码机具扫描用户出示的付款码,来实现收款。
扫码支付#
商家提供收款二维码,由用户通过企业钱包sdk扫码,来实现支付。SDK文档 2.接入前准备#
2.1商务准备#
直签模式:指商户与企业钱包直接签约。具体流程:商户可以通过企业钱包线上进件接口,提交准备好的入网材料,并通过接口查询进件进度和结果,待审核通过入网成功后,企业钱包技术支持将会把企业站后台账号及密码发送给商户。服务商模式:指服务商与企业钱包直接签约。具体流程:服务商完成协议签署后,将准备好的入网材料提供给企业钱包运营人员,企业钱包运营人员发起商户入网申请,待审核通过入网成功后,企业钱包技术支持将会把企业站后台账号及密码发送给服务商。服务商商户进件接口2.2对接准备#
2.2.1密钥获取#
2.2.2公共参数获取#
服务商获取参数:sp_no
商户获取参数:mch_id
可以联系企业钱包技术支持提供对应参数,或者登陆企业站后台进行查看2.2.3服务开通及配置#
3.开发指引#
3.1对 接规范#
调用接口,以及异步通知接口,均采取POST形式提交,数据格式统一为JSON格式。3.2系统调用流程#
3.2.1支付流程#
用户支付申请,获取支付二维码以及支付授权authCode
企业钱包发送支付确认请求给商户,由商户判断是否可以支付这笔交易
3.2.2接口信息#
| | |
|---|
| API | 额度申请 | 商户给用户或者员工进行虚拟卡的发放,此接口中带有用户信息相关字段,进行卡申请时,会判断上送的user_id是否存在,如果不存在会先进行用户创建,再发卡;如果user_id存在,则会对比用户信息,如果有变化,怎么更新用户信息,并发卡。只有进行虚拟卡发放,才能进行后续的支付操作 |
| API | 额度详情 | 用于查询虚拟卡的卡信息,例如卡余额,有效期,卡片名称等 |
| API | 获取SDK授权 | 通过支付申请中获取的授权码authcode,唤起SDK,如果是小程序使用,则不需要使用SDK |
| API | 支付实时确认 | 企业钱包向商户发送支付确认通知,商户可以通过自己业务逻辑判断是否接受或者拒绝这笔支付 |
| API | 额度申请结果通知 | 异步通知接口,用于返回卡申请的结果,申请卡的卡号信息,申卡失败原因 |
| API | 交易结果通知 | 异步通知接口,用于通知商户,交易支付结果及错误码信息,订单信息等 |
| API | 交易退款通知 | 异步通知接口,用于通知商户,支付交易退款结果及退款资金信息 |
| API | 交易撤销通知 | 异步通知接口,用于通知商户,支付交易撤销结果,撤销是指资金在结算前,收单商家发起的订单退款 |
4.测试指引#
4.1生产测试#
4.2测试环境测试#
4.3测试步骤#