商家安装支付应用流程​

本文档介绍商家如何发现、安装、授权和激活支付应用程序，以及支付应用方如何跟 SHOPLINE 平台打通流程。

商家激活使用支付应用​

发现​

如果该支付应用对当前店铺是可见的，那商家可以直接在 设置-收款 中进行设置

• 采取直连模式的支付应用：用户在 设置-收款-添加支付服务商 中选择该支付应用

• 采取外跳模式的支付应用：用户在 设置-收款-添加其他支付方式 中选择该支付应用

安装&激活​

选择支付应用后，将进入支付应用安装页面，该页面会展示支付应用的基础信息及描述信息。

点击安装，此时用户会被重定向到支付应用授权页面：

授权完成之后，将重定向到你配置的应用回调地址，最终需要跳转到你维护的支付收款账号绑定页面；用户将在该页面完成 SHOPLINE 店铺与支付收款账号的绑定。

绑定完成后，您最终需要将用户重定向到回 SHOPLINE 商家后台，让用户可以完成后续的激活动作； 具体的页面链接格式为： https://{handle}.myshopline.com/admin/settings/payments/appInstall?appKey=xxxxx

注意：由于此时在 SHOPLINE 商家后台内嵌的授权页面进行重定向回SL Admin后台的操作，需要在该流程接入 App Bridge，否则将会出现页面嵌套的情况；

同时，支付应用需要调用 绑定成功通知 接口，告知 SHOPLINE 商户已经完成绑定；此时支付方式激活按钮才会变为可以点击；商家点击激活后，该支付方式会在结算页展示并可使用。

最终你的支付应用，将会在结算页展示，并可供消费者选择：

对接流程​

商家安装激活流程​

该流程涉及到插件的授权回调流程，此处将结合该流程统一描述 名词解释：

由于该场景比较复杂，我们将给出一个建议的最佳实践，你可以参考该流程来完成您的授权&安装流程；

红色：该节点依赖商家操作； 绿色：该节点逻辑/页面由支付应用系统实现； 蓝色：该节点页面由SHOPLINE平台实现；

商家卸载支付应用​

商家不再使用支付应用时，可以在支付配置详情页卸载该应用；此时 SHOPLINE 开放平台将广播应用卸载事件，支付应用方应该要关注该事件，并维护好商家数据；确保商家再次启用时，能正确的再次进入支付应用的授权流程。

支付应用的审核与发布​

你的支付应用需要先在开放平台审核通过，然后商家才能将其安装使用它。

支付应用的灰度控制​

开发者开发应用审核通过之后，默认所有商家都是不允许看到该应用，此时需要联系 SHOPLINE 审核人员为该应用分配灰度测试商家，此时只有灰度中的店铺才能看见该应用。 在充分测试完成后，你可以再次联系 SHOPLINE 审核人员全量开放该应用，全量发布后。该支付应用对所有商家可见。