0

0

苹果支付PHP接口怎么调用_苹果支付PHP接口调用方法【指南】

絕刀狂花

絕刀狂花

发布时间:2025-12-26 22:03:16

|

693人浏览过

|

来源于php中文网

原创

PHP验证苹果IAP需:一、构造标准JSON请求体并POST至对应环境URL;二、自动识别21007/21008错误并切换环境重试;三、订阅需添加password字段传shared secret;四、推荐用Guzzle封装提升稳定性;五、解析响应时优先匹配latest_receipt_info中的product_id与transaction_id。

苹果支付php接口怎么调用_苹果支付php接口调用方法【指南】

如果您在开发 iOS 应用时需完成苹果内购(IAP)支付结果的后端验证,但服务端 PHP 无法正确调用苹果验证接口并解析响应,则可能是由于请求格式、环境误配或 receipt 数据处理不当所致。以下是调用苹果支付 PHP 接口的具体方法:

一、构造标准 JSON 请求体并 POST 到苹果验证地址

苹果要求将 receipt-data 封装为严格格式的 JSON 对象,并以 application/json Content-Type 发送至对应环境的验证接口。沙盒环境与生产环境 URL 不同,必须根据实际部署状态选择,否则将返回 21007 或 21008 错误。

1、将客户端传入的 base64 编码 receipt 字符串进行 URL 安全解码(若含换行或空格需先清理)。

2、构建关联数组:["receipt-data" => $decoded_receipt],注意键名必须为 receipt-data,不可使用驼峰或下划线变体。

立即学习PHP免费学习笔记(深入)”;

3、使用 json_encode() 将数组转为 JSON 字符串,确保不带额外空格或 UTF-8 BOM。

4、设置 cURL 请求头:Content-Type: application/json;Accept: application/json。

5、POST 该 JSON 字符串至 https://sandbox.itunes.apple.com/verifyReceipt(沙盒)或 https://buy.itunes.apple.com/verifyReceipt(生产)。

二、自动识别并重试沙盒/生产环境

当首次验证返回 status=21007(沙盒 receipt 发往生产)或 status=21008(生产 receipt 发往沙盒)时,应主动切换验证地址重新提交,避免人工判断环境。该机制可提升接口鲁棒性,尤其适用于灰度发布或测试阶段混用凭证的场景。

1、执行第一次请求,获取原始响应 JSON 字符串。

2、json_decode() 解析响应,检查 status 字段值是否为 "21007" 或 "21008"。

3、若命中任一状态码,提取原 receipt-data 值,切换目标 URL 为另一环境地址。

4、重复 POST 请求,使用相同 JSON 结构和 header 配置。

5、将两次响应中的有效字段(如 latest_receipt_info、in_app 数组)合并记录,用于后续业务处理。

三、携带 shared secret 处理自动续订订阅

对于订阅型商品(尤其是含免费试用或跨档升级),苹果要求在请求体中额外提供 shared secret(即 App Store Connect 中配置的“App-Specific Shared Secret”)。缺失该字段将导致 status=21004 错误,且无法获取完整订阅状态信息。

1、在 App Store Connect 的【用户与访问 → 密钥】或【我的 App → 商务 → In-App Purchases】中找到对应 App 的 shared secret 值。

海螺AI
海螺AI

MiniMax平台的AI对话问答工具,你的AI伙伴

下载

2、修改请求体数组,增加 "password" => "your_shared_secret_here" 键值对(注意字段名为 password,非 shared_secret 或 secret)。

3、确保该 secret 仅存储于服务端配置,严禁硬编码在前端或日志中输出。

4、重新发起验证请求,响应中将包含 expires_date、is_trial_period、auto_renew_status 等关键订阅字段。

四、使用 Guzzle HTTP 客户端封装验证逻辑

Guzzle 提供更稳定的异步控制、超时管理及异常捕获能力,相比原生 cURL 更适合高并发验证场景。其默认启用连接池与重试策略,可减少因苹果服务瞬时抖动导致的失败。

1、通过 Composer 安装 guzzlehttp/guzzle:composer require guzzlehttp/guzzle

2、实例化 Guzzle 客户端,设置 timeout=10、connect_timeout=5、http_errors=false(避免 4xx/5xx 直接抛异常)。

3、调用 $client->post() 方法,传入 URL 和 ['json' => $payload] 参数,自动序列化并设置 header。

4、捕获 GuzzleException,对 ConnectionException 或 ServerException 进行降级处理(如写入延迟队列重试)。

5、对响应 body 调用 $response->getBody()->getContents() 获取原始 JSON 字符串。

五、解析响应并提取有效 in_app 订单数据

苹果验证成功(status=0)后,响应体中包含 receipt 字段(基础收据)和 latest_receipt_info 字段(最新交易列表),后者为数组,每项代表一次购买/续订事件。需从中匹配订单号或 product_id,而非直接信任客户端传入的 transactionIdentifier。

1、json_decode() 响应内容,检查 status 是否严格等于 0(注意是整数 0,非字符串 "0")。

2、优先读取 latest_receipt_info 数组,遍历每一项,比对其中的 product_id 与业务订单所关联的商品 ID。

3、确认该项的 transaction_id 与客户端上报的 transactionIdentifier 一致,且 purchase_date_ms 大于本地订单创建时间戳。

4、提取该条目的 quantity、original_transaction_id、expires_date_ms(订阅)等字段,用于更新数据库状态。

5、若 latest_receipt_info 为空,则回退至 receipt->in_app 数组(仅适用于一次性购买)。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

1718

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1144

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1048

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

948

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1396

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1228

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1439

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1303

2023.11.13

虚拟号码教程汇总
虚拟号码教程汇总

本专题整合了虚拟号码接收验证码相关教程,阅读下面的文章了解更多详细操作。

25

2025.12.25

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 7.9万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 6.9万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.8万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号