需通过苹果App Store服务器验证base64收据:先解码构造JSON请求,再依环境选择沙盒/生产URL用cURL提交;解析响应时严格校验status=0,并提取in_app或latest_receipt_info判断订单与订阅状态;最后用SHA-256缓存结果防重放。

如果您在PHP环境中需要验证苹果应用内购买(IAP)订单的有效性并查询其状态,则需通过苹果App Store服务器验证交易收据。以下是实现苹果支付订单查询的具体步骤:
苹果支付返回的原始收据为base64编码字符串,必须先将其解码并构造为符合苹果验证接口要求的JSON请求体。该收据通常来自iOS客户端调用SKPaymentQueue的transactionReceipt属性或StoreKit 2的Transaction对象导出。
1、从客户端接收包含receipt-data字段的HTTP POST请求参数。
2、使用base64_decode()函数对receipt-data值进行解码,确保未出现填充字符截断或编码错误。
立即学习“PHP免费学习笔记(深入)”;
3、将解码后的二进制数据封装为关联数组:["receipt-data" => $decoded_receipt],必要时追加"password"字段(对应App Store Connect中设置的共享密钥,仅适用于自动续订订阅)。
苹果提供两个环境对应的验证端点:沙盒环境用于开发测试,生产环境用于已上架应用。必须根据收据来源选择正确URL,并使用POST方法提交JSON格式载荷,且需设置标准HTTP头以确保服务响应准确。
1、判断收据是否可能来自沙盒环境:可先尝试向https://sandbox.itunes.apple.com/verifyReceipt发送请求,若返回状态码21007则说明收据实为生产环境生成,需重试生产地址。
2、使用cURL初始化连接,设置CURLOPT_POST为true,CURLOPT_POSTFIELDS为JSON编码后的请求数组,CURLOPT_HTTPHEADER包含Content-Type: application/json。
3、启用SSL验证(CURLOPT_SSL_VERIFYPEER设为true)并指定CA证书路径,防止中间人攻击;超时时间建议设为30秒以上以应对苹果服务延迟。
苹果验证接口返回标准JSON对象,其中status字段标识验证结果,receipt子对象包含原始收据解析后的内容,latest_receipt和latest_receipt_info用于追踪订阅最新状态。必须严格校验status值而非仅依赖HTTP状态码。
1、使用json_decode($response, true)将响应体转为PHP关联数组。
2、检查status是否等于0,该值表示收据有效且经签名验证通过;其他值如21002(收据数据损坏)、21003(收据无法验证)、21005(Apple服务器暂时不可用)需按对应逻辑处理。
3、当status为0时,读取receipt->in_app数组中的每一条记录,比对original_transaction_id或transaction_id确认目标订单,并提取product_id、purchase_date_ms、expires_date_ms(订阅)等关键字段。
对于自动续订订阅,苹果返回的latest_receipt_info数组按时间倒序排列,最新一条即为当前有效订阅周期。需结合expires_date_ms与服务器本地时间比对,以确定用户权益是否仍在有效期内。
1、遍历latest_receipt_info数组,找到is_trial_period为"false"且expires_date_ms最大的条目(排除试用期结束但未续订的旧记录)。
2、将expires_date_ms除以1000转换为秒级时间戳,与time()返回值比较;若前者大于后者,则视为有效订阅。
3、若存在auto_renew_status为"0"的记录,表明用户已关闭自动续订,需标记下次到期后将终止服务,但当前周期仍应视为有效直至expires_date_ms到达。
为避免重复验证同一收据导致苹果接口限流或误判,应在服务端建立轻量级收据指纹索引。苹果要求同一收据多次提交时返回相同结果,但高频请求可能触发临时封禁,因此需本地缓存验证结果并设定合理TTL。
1、对原始receipt-data字符串计算SHA-256哈希值,作为唯一缓存键。
2、将验证成功的结果(含status、in_app数组、latest_receipt_info)序列化后存入Redis或Memcached,设置TTL为3600秒(1小时),覆盖典型订阅查询频次窗口。
3、每次收到新查询请求时,先检索缓存键是否存在且未过期;若命中则直接返回缓存数据,跳过向苹果服务器发起网络请求,显著降低延迟与外部依赖风险。
以上就是PHP如何实现苹果支付订单查询_苹果支付订单查询PHP实现步骤【指南】的详细内容,更多请关注php中文网其它相关文章!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号