1.产品介绍#
1.1简介#
财智卡也称为VCC卡,全称为Virtual Credit Card(虚拟信用卡),是用于境外交易的虚拟卡,它并不以实体卡片形式存在,而是由银行或第三方金融机构发行的一种临时或一次性使用的信用卡号码。虚拟信用卡拥有独立的卡号、安全码(CVV)和有效期。1.2应用场景#
钱包支付#
绑定钱包应用(ApplePay、GooglePay等)
绑卡支付#
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支付流程#
进行交易支付,预授权冻结金额(例如,订单金额:10 USD,预授权冻结73 CNY)
实际订单结算(预授权冻结金额:73 CNY,实际结算金额:70 CNY),根据结算金额,去扣除商户资金账户金额,如果结算金额小于冻结金额,会返还多余的冻结金额,如果结算金额大于冻结金额,则会从商户资金账户中扣除不足的部分。
3.2.2接口信息#
| | |
|---|
| API | 卡申请 | 商户给用户或者员工进行虚拟卡的发放,此接口中带有用户信息相关字段,进行卡申请时,会判断上送的user_id是否存在,如果不存在会先进行用户创建,再发卡;如果user_id存在,则会对比用 户信息,如果有变化,怎么更新用户信息,并发卡。只有进行虚拟卡发放,才能进行后续的支付操作 |
| API | 财智卡敏感信息查询 | 用于查询虚拟卡的安全码以及完整的卡号,只有VCC卡和token卡有这两个信息 |
| API | 财智卡详情 | 用于查询虚拟卡的卡信息,例如卡余额,有效期,卡片名称等 |
| API | 财智卡申请结果通知 | 异步通知接口,用于返回卡申请的结果,申请卡的卡号信息,申卡失败原因 |
| API | 授权交易通知 | 异步通知接口,用于通知商户,交易支付结果及错误码信息,订单信息等 |
| API | 交易结算通知 | 异步通知接口,用于通知商户,支付交易资金结算信息 |
4.测试指引#
4.1生产测试#
4.2测试环境测试#
4.3测试步骤#
1.首先登陆企业钱包后台,在商务卡-卡列表中,用条件筛选,筛选出 境外消费 卡用来测试交易
2.登录测试平台,点击VCC交易,选择 支付申请,这里的*付款卡号,对应的是VCC卡的 商务卡编号,并不是卡号(境外消费卡中,有卡号的是VCC卡,无卡号的,是企业码)
3.填写好信息后,点击提交,会出现对应的支付单号信息(orderNo),支付单号信息需要记录下来,然后点击 支付完成 进入下一个环节
4.这里可以选择支付成功还是支付失败(注意:这里的支付成功或者失败是指的信息流,也就是卡额度扣除是否成功)
5.支付撤销 如果要测试,需要在结算之前才能撤销,一旦结算,是走退款流程
6.结算 测试的时候,如果要测试退款,则一定要先对订单进行结算,不然会提示订单未结算的错误