苹果应用内购 ios 开发者根据用户提供的邮件中的订单号查看该订单是否支付成功.

分类: AppStore

2021-10-19

这是苹果wwdc2021 推出的新功能

参考官网链接

App Store Server API | Apple Developer Documentation

https://developer.apple.com/documentation/appstoreserverapi

先要通过 JWT签名

https://developer.apple.com/documentation/appstoreserverapi/generating_tokens_for_api_requests

作者：Yanlongli [email protected]

来源：博客园苹果应用内购 ios 开发者根据用户提供的邮件中的订单号查看该订单是否支付成功 - IM小白 - 博客园 (cnblogs.com)

参考以下PHP伪代码

$privateKey = <<<key
-----BEGIN PRIVATE KEY-----
xxxx
-----END PRIVATE KEY-----
key;


$payload = [
    'iss' => 'xxxxxx',
    "iat" => time() - 10,
    "exp" => time() + 3590,
    "aud" => "appstoreconnect-v1",
    "nonce" => "随机字符串",
    "bid" => "xxx.xxx.xxx.xxx",
];

$auth_token = JWT::encode($payload, $privateKey, 'ES256', '私钥id');

iss 通过 https://appstoreconnect.apple.com/access/api 获得，操作路径是   用户和访问、密钥、App Store Connect API、Issuer ID
bid 是应用的 bundleid
iat 当前时间戳，到秒的，-10 是测试发现，接口直接请求时有几率失败，应该时本地时间和苹果服务器时间有误差导致失败，减去10秒不影响请求，能忽略时间差。
exp 过期时间戳，在这个时间之后，该签名会失效，苹果文档给的是60分钟，应该可以更久，看你需求
nonce 随机字符串 6edffe66-b482-11eb-8529-0242ac130003  这是苹果给的格式，我也这么生成的，没测试是否任意随机字符串都可以
私钥id 通过在上面相同网址中，密钥页面，创建一个密钥，或者用已存在的密钥，列表会显示密钥id，注意该私钥仅允许下载一次，所以你要保存好，忘了的话就要创建一个新的密钥。

// 签名后通过get请求
https://api.storekit.itunes.apple.com/inApps/v1/lookup/{tradeNo}

headers 添加上认证方式
Authorization: Bearer {auth_token}
{tradeNo} 替换成用户邮件收到的订单号
{auth_token} 替换成上面伪代码的签名

请求成功会返回
{
    "status": 0,
    "signedTransactions": [
        "header.payload.sign"
    ]
}

signedTransactions 的格式是头.载体.签名

如果有需要自行处理签名验证，这里不验证了

将 signedTransactions 按 . 点分割,获取载体内容 payload,再将这个payload字符串base64解码，即可得到该订单的内容，参考如下

{
    "transactionId": "xxx",  // 本次交易号
    "originalTransactionId": "xxx", // 第一次交易号
    "webOrderLineItemId": "xxx",
    "bundleId": "com.xx.xx", // 应用的 bundleid
    "productId": "com.xx.xx.xxx", // 套餐商品的唯一标识key
    "subscriptionGroupIdentifier": "xx",  // 订阅组id
    "purchaseDate": 1631718985000, // 支付时间
    "originalPurchaseDate": 1599242074000, // 首次支付时间
    "expiresDate": 1634310985000, // 过期时间，订阅有效
    "quantity": 1, // 数量
    "type": "Auto-Renewable Subscription", //类型 非订阅的是 Non-Renewing Subscription
    "inAppOwnershipType": "PURCHASED",  //
    "signedDate": 1634625372402 // 请求响应的签名时间
}

其他api https://api.storekit-sandbox.itunes.apple.com/inApps/v1/history/{originalTransactionId}

https://api.storekit.itunes.apple.com/inApps/v1/subscriptions/{originalTransactionId}