开始使用

AMPE

多端开发

插件

插件介绍

插件获取与使用

插件开发

插件发布

插件管理

插件授权

插件后端开发

插件快捷联调

插件多端开发

小程序模板使用插件

插件版本升级

协助小程序更新插件

插件技术知识汇总

附录

安全

openid 开发指南

扩展能力

开发 > 指南 > 插件 > 插件管理 > 插件后端开发

插件后端开发

更新时间：2024-04-07 07:10:13

贡献者

背景

插件不能独立运行，必须依附在其他的主体小程序上。当插件需要获取商家拥有的支付宝能力的时候，必须协助商家调用支付宝接口，所以插件服务端最重要的概念就是 代调用。

服务端开发准备

插件服务端开发需要下载支付宝服务端 SDK。

插件代调用

插件代替商家来调用支付宝产品时候，需要获得商家授权发送 app_auth_code 换取 app_auth_token。授权消息相关操作可查看插件授权，完成消息处理后请配送应用网关。

商家授权是授权商家下面某一个应用给插件代调用，所以插件服务端需要建立 PID - auth_app_id - app_auth_token 三者唯一关系。

当插件代理商家获取用户信息时候，需要用户授权发送 auth_code 给插件代理换取 access_token，最终用 app_id(三方应用 id) + app_auth_token + access_token 请求接口获得用户信息。

获得 app_auth_token

app_auth_token：插件授权获取的 token，用于服务商协助商家发起请求。

当商家订购插件时，会授权插件行使代调用权限，app_auth_token 回调发送给插件的网关。在联调获取 app_auth_token 前，必须配置完成 应用网关。

app_auth_token 回调以下信息发送网关：

第三方应用授权

下单消息：商家完成订购插件后服务商收到的关于商家的相关订单消息。

配置应用网关

用于接收支付宝异步通知，例如口碑开店中，需要配置此网关来接收开发者门店被动通知。

在配置完成 应用网关 后，订购小程序插件时会推送最新的 app_auth_token 给插件服务端，采用这种方式可以验证模拟商家订购插件回调 app_auth_token 的过程。

获得 app_auth_token 的两种方法

方法一： 商家订购插件，app_auth_token 回调发送给插件。

方法二： 在小程序插件详情页的 插件管理 > 授权管理 中查找对应的 app_auth_token。

获得 auth_token

auth_token：用户信息授权获取的 token，用于获取用户信息。

使用插件用户授权，获取用户的 auth_code，再换取 auth_token。

获得 auth_code

获取 auth_code 详情请查看 my.getAuthCode。

通过 auth_code 换取 auth_token

//插件开发者私钥，由开发者自己生成 参考 https://docs.open.alipay.com/200/105310#s2
String appPrivateKey = "MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCKnImlg1tZYi4UBFwk3A4L3LjuAy";
//支付宝公钥，由支付宝生成
String alipayPublicKey = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4r6vW";
String format = "json";
String charset = "UTF-8";
String signType = "RSA2"; //商家生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA，推荐使用RSA2
String serverUrl = "https://openapi.alipay.com/gateway.do";
String appId = "2018071660683196"; //插件id
String appAuthToken = "1cc19911172e4f8aaa509c8fb5d12F56"; //商家授权token https://docs.open.alipay.com/20160728150111277227/intro
String authCode = "bc95009acbe1401cabec35cece99SC12"; // 用户授权码
AlipayClient alipayClient = new DefaultAlipayClient(serverUrl, appId, appPrivateKey, format, charset, alipayPublicKey, signType);
try {
    AlipaySystemOauthTokenRequest request = new AlipaySystemOauthTokenRequest();
    request.setGrantType("authorization_code");
    request.setCode(authCode);
    AlipaySystemOauthTokenResponse response = alipayClient.execute(request, null, appAuthToken);
    System.out.println(response.getAccessToken());
} catch (AlipayApiException e) {
    e.printStackTrace();
}

代调用获取用户信息

简单说代调用获取用户信息，是利用 app_id(插件应用 id) + app_auth_token+access_token 调用接口获取用户信息。

//插件开发者私钥，由开发者自己生成 参考 https://opendocs.alipay.com/mini/introduce/01p6u8
String appPrivateKey = "MIIEvQIBADANBgkqhkiG9w0BAQEFAASCBKcwggSjAgEAAoIBAQCKnImlg1tZYi4UBFwk3A4L3LjuAy";
//支付宝公钥，由支付宝生成
String alipayPublicKey = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4r6vW";
String format = "json";
String charset = "UTF-8";
String signType = "RSA2"; //商家生成签名字符串所使用的签名算法类型，目前支持RSA2和RSA，推荐使用RSA2
String serverUrl = "https://openapi.alipay.com/gateway.do";
String appId = "2018071660683196"; //插件 id
String appAuthToken = "1cc19911172e4f8aaa509c8fb5d12F56"; //商家授权token https://opendocs.alipay.com/isv/10467/xldcyq
String accessToken = "22c19911172e4f8aaa509c8fb5d12F56"; //用户授权token
AlipayClient alipayClient = new DefaultAlipayClient(serverUrl, appId, appPrivateKey, format, charset, alipayPublicKey, signType);
try {
    AlipayUserInfoShareRequest request = new AlipayUserInfoShareRequest();
    AlipayUserInfoShareResponse response = alipayClient.execute(request, accessToken, appAuthToken);
    response.getUserId();
    response.getUserName();
} catch (AlipayApiException e) {
    e.printStackTrace();
}