本文档介绍线下零售商家在接入智慧门店全渠道解决方案时,原有当面付链路必须的改造内容。
阅读对象:已与支付宝对接当面付,并计划接入智慧门店的商家/ISV开发人员。
商家在智慧门店全渠道中心通过平台或接口创建门店后,在调用支付宝当面付支付接口alipay.trade.pay时,需传入 门店编号 store_id 参数,参数值为创建门店时录入或传入的商家原有门店编号。
商家在智慧门店全渠道中心通过平台或接口创建操作员子账号后,在调用支付宝当面付支付接口alipay.trade.pay时,需传入 操作员编号 operator_id 参数,参数值为创建操作员子账号时录入或传入的商家原有人员编号。
商家在智慧门店全渠道中心通过平台或接口发布商品后,在调用支付宝当面付支付接口alipay.trade.pay时,需传入 商品明细信息 goods_detail 参数传入,注意这个参数是个数据集,包含几个子参数,以JSON列表的形式支持同时传入多个商品。
子参数名称 | 子参数说明 | 是否可空 |
---|---|---|
goods_id | 商户自定义的商品编号,需要与在智慧门店发布商品是传入的外部商品编号一致。 | 不可空 |
goods_name | 商户自定义的商品名称,注意编码格式与调用接口指定的编码一致。 | 不可空 |
quantity | 本次交易购买的商品数量 | 不可空 |
price | 商品单价,单位元,商品优惠前的价格。商品单价x数量的累加金额=订单总金额(不做强行校验) | 不可空 |
参数样例: "goods_detail":[ { "goods_id":"apple-01", "goods_name":"ipad", "quantity":1, "price":2000 } ]
门店调用支付宝当面付退款接口alipay.trade.refund时,需传入本次退货的商品明细 goods_detail 参数, 参数格式与正向支付传入的商品明细信息 goods_detail 参数一致。
子参数名称 | 子参数说明 | 是否可空 |
---|---|---|
goods_id | 商户自定义的商品编号,需要与在智慧门店发布商品是传入的外部商品编号一致。 | 不可空 |
quantity | 本次退款的商品数量 | 不可空 |
参数样例: "goods_detail":[ { "goods_id":"apple-01", "quantity":1 } ]
若商户有需求,分公司、经销商、分门店独立收款(非总公司签约账号收款),需要一次性提供所有收款账号,联系对应支付宝BD添加入销售方案收款限制集;
然后通过在支付宝商家中心配置经营信息(分公司信息及门店信息配置),建立门店id与收款账号的对应关系,通过当面付接口传入的store_id判断收款账号,收款到对应支付宝账号实现
商家中心经营信息配置
通过处理支付成功后响应的fund_bill_list参数,可以获取本次支付使用的资金渠道信息,便于在小票中透出本次支付的实际商家优惠情况,其中:
fund_channel:交易使用的资金渠道,支付渠道列表,主要几个类型说明:
参数名称 | 参数说明 |
---|---|
MDISCOUNT | 商户优惠券,商户出资部分。智慧门店新增的淘宝门店优惠券将在这里透出,所有商户出资优惠券都会在这里合并返回 |
ALIPAYACCOUNT | 支付宝账户,指消费者的支付余额、余额宝等支付渠道资金。 |
DISCOUNT | 平台出资的优惠,比如支付宝鼓励金,商家收到的资金依然是原价。 |
小票具体的规范要求参考:小票规范
若需要线上测试商家优惠返回,可由商家使用当面付签约账号登录支付宝商家运营中心创建测试运营活动,领券后支付一笔,门店测试查看小票内容是否有相关商家优惠
当面付升级改造完成后,需要商户进行在线云验收,验证门店编号及商品明细是否传入
具体验收流程:商户签约账号登录云验收后台设置验收人(付款人,一般为支付ISV测试验收人),验收人按云验收指引,选择“智慧门店”产品,完成支付及退款验收查看验收结果:
.没有传入商品明细与门店编号,验收结果显示为黄线警告
.有传入商品明细与门店编号,则绿底文字提示,商品明细goods_detail还会显示具体的明细列表参数。
验收成功进行截图保存,上线前提供智慧门店的实施同学@梓晗@溪行确认
具体智慧门店当面付升级对接细节,请开发者扫码加入开发者大群咨询: