接入准备 -凯发app官方网站更新时间：2022-12-13 11:26:30收藏我的文档设置返回文档本文展示了如何从零开始，使用支付宝开放平台服务端 sdk 快速接入 商户会员卡 能力。商户会员卡 能力支持如下接入方式，商家和服务商可根据实际业务需要选用：●自研商家可通过 自研应用 接入。●服务商可通过 代开发（传入 app_auth_token）模式代商家接入。详情可查看下文 服务商代商家接入说明。自研商家接入说明1. 创建应用登录，创建 小程序应用 或 网页&移动应用。说明：生成的应用唯一标识 appid 可用于调用开放产品接口。2. 配置应用添加能力创建小程序后，在 能力管理 中添加 商户会员卡 产品。开发设置在 开发设置 中配置应用信息。接口加签方式必填。用于防止数据篡改，保障小程序和支付宝交互的安全性，可查看 接口加签方式。服务器 ip 白名单选填。用于提高小程序访问开放平台的安全性，避免因应用私钥泄漏等原因导致业务受损，保障用户资金安全，可查看 服务器 ip 白名单。支付宝网关必填。开发者调用 openapi 发送 http(s) 请求至支付宝的目标地址（gateway），固定为 https://openapi.alipay.com/gateway.do。应用网关必填。用于接收支付宝异步通知消息，需要传入 http(s) 公网可访问网页地址，可查看 应用网关。接口内容加密方式选填。用于加 / 解密 openapi bizcontent 报文内容，可大幅提升接口内容传输的安全性。可查看 接口内容加密方式。服务器域名白名单选填。若支付宝小程序需要获取客户端域外资源（例如获取图片、服务端数据等），需要配置服务器域名白名单。h5域名选填。使用 web-view h5 页面承载组件 时需要配置 h5 页面中所有域名地址（含静态资源地址，如图片、.js 文件地址等），详情可查看 配置 h5 域名。3. 申请用户信息支付宝商户会员卡默认不自动回填用户信息，投放会员卡至 iot 设备或期望获取用户授权后自动回填用户信息的商家可参照本流程完成自主申请。第一步：配置主营行业类目小程序●创建小程序时若未指定小程序类目需在对应小程序详情页 小程序信息 中补充 主营行业 ，否则功能列表无法显示 申请用户信息 入口。●若已配置小程序类目但仍无 申请用户信息 入口，表示该类目不支持申请此用户信息。●小程序商户会员卡场景支持申请用户信息主营行业类目与使用场景表可查看 商户会员卡。网页&移动应用不同的行业类目支持申请的用户信息也不同，您需要使用支付宝商家账号登录 商家中心 > 账号中心 并在 中完善或修改 商户基本信息 > 商家类目。第二步：自助申请应用上线后，如需自动回填用户手机号等信息，商家可点击 用户信息申请 按钮，进行自助申请。注意：●用户信息申请不支持个人账号类型的商家，用户信息申请入口将会隐藏。●请使用主账号申请用户信息，子账号将无法看到用户信息申请入口。●当商户会员卡功能包下所有可申请的用户信息字段都处于 已开通 状态，则用户信息申请入口也会隐藏，但不会影响用户信息字段的调用。第三步：可申请字段列表点击右侧的 申请权限 按钮，进入申请页（由于每个字段都有各自的场景，目前需要逐个申请）。注意：由于用户信息的行业限制，不同行业商家看到的可申请的信息字段可能不同。第四步：填写申请表单填写表单，提交申请后将进入审核状态。审核通过后即可获得用户信息字段权限。注意：●请严格按照每个字段和 demo 的要求来填写，否则将被驳回。●小程序商户会员卡场景支持申请用户信息主营行业类目与使用场景表查看 商户会员卡。●上传 demo 需展示如下信息，否则用户信息申请可能被驳回：○包含完整用户信息使用场景：此处申请 alipay.user.info.share 接口获取用户信息仅支持商户会员卡功能使用。○用户授权完整场景：包括 1.触发授权弹窗的上级场景；2.请求用户授权的弹窗；3.用户同意授权的下级场景；4.用户拒绝授权的下级场景。服务商代开发模式接入1. 创建应用服务商登录 ，创建 第三方应用 并提交审核。详情可查看 创建第三方应用。说明：生成的应用唯一标识 appid 可用于调用开放产品接口。2. 添加产品服务商需为第三方应用添加 商户会员卡 产品。3. 获取代开发授权服务商需根据 第三方应用授权 指引，获取商家代开发授权，以此获取 app_auth_token（商家授权令牌）用于调用商户会员卡相关接口。4. 代商家申请用户信息支付宝商户会员卡默认不自动回填用户信息，投放会员卡至 iot 设备或期望获取用户授权后自动回填用户信息的服务商，可参照 代申请用户信息 流程完成申请。5. 接口调用服务商代商家调用服务端接口时：1需传入第三方应用授权得到商家授权令牌（app_auth_token）作为请求参数传入。2使用第三方应用的支付宝公钥、应用公钥、应用私钥、appid（证书模式使用第三方应用证书）构造 alipayclient，其余入参与接口文档相同。更多详情可查看 代调用 openapi。集成并配置 sdk开发者需要在自己的服务端系统中集成 sdk ，用于后续调用服务端接口。下载服务端 sdk为了帮助开发者调用开放接口，支付宝提供了 开放平台服务端 sdk，包含 java、php、nodejs、python 和 .net 五种语言，封装了签名 & 验签、http 接口请求等基础功能。说明：请先下载对应语言最新版 sdk 并引入开发工程。接口调用配置在 sdk 调用具体的 api（接口）前需要进行 alipayclient 对象初始化。alipayclient 对象只需要初始化一次，后续调用不同的 api 都可以使用同一个 alipayclient 对象。公钥模式加签接口加签方式为 公钥 模式加签时 alipayclient 对象初始化的 java 语言示例代码：关键参数说明配置参数示例值解释获取方式/示例值url支付宝网关（固定）。https://openapi.alipay.com/gateway.doappidappid 即创建小程序后生成。获取可查看 获取 appid。private_key开发者私钥，由开发者自己生成。获取可查看 接口加签方式。format参数返回格式，只支持 json（固定）。jsoncharset编码集，支持 gbk/utf-8。开发者根据实际工程编码配置。alipay_public_key支付宝公钥，由支付宝生成。获取详情可查看 接口加签方式。sign_type生成签名字符串所使用的签名算法类型，目前支持 rsa2 和 rsa，推荐使用 rsa2。rsa2公钥证书模式加签接口加签方式为 公钥证书 模式加签时，alipayclient 对象初始化的 java 语言示例代码如下：注意：若使用 公钥证书 模式进行加签，需额外引入如下 jar 包：●●●关键参数说明配置参数示例值解释获取方式/示例值url支付宝网关（固定）。https://openapi.alipay.com/gateway.doappidappid 即创建小程序后生成。获取可查看 获取 appid。private_key开发者私钥，由开发者自己生成。获取可查看 接口加签方式。format参数返回格式，只支持 json（固定）。jsoncharset编码集，支持 gbk/utf-8。开发者根据实际工程编码配置。sign_type生成签名字符串所使用的签名算法类型，目前支持 rsa2 和 rsa，推荐使用 rsa2。rsa2app_cert_path应用公钥证书文件本地路径。获取详情可查看 接口加签方式。alipay_cert_path支付宝公钥证书文件本地路径。获取详情可查看 接口加签方式。alipay_root_cert_path支付宝根证书文件本地路径。获取详情可查看 接口加签方式。
