苹果APP内购回调PHP怎么接收_处理iOS内购通知参数方法【操作】

苹果内购回调PHP处理核心是必须用官方接口二次验签并自动适配沙盒/正式环境；需清洗receipt-data换行符、先正式地址验签失败再按status码切换、从in_app数组取transaction_id等字段、v2订阅通知需JWT验签且与v1不兼容。

苹果内购回调 PHP 接收和处理的核心是：别直接信客户端传的 receipt-data，必须用 Apple 官方接口二次验签，且要自动适配沙盒/正式环境 —— 否则 90% 的失败都卡在这一步。

怎么接收 iOS 传来的 receipt-data？注意换行和 base64 编码陷阱

iOS 端调用 SKPaymentTransaction.transactionReceipt 后会返回原始二进制数据，再经 base64EncodedString(options: .endLineWithLineFeed) 编码 —— 这意味着字符串里可能含 \n 和 \r，但 PHP 的 $_POST 或 $this->request->post() 默认不会自动 trim 换行符，会导致验签失败（状态码 21002）。

• 务必对 receipt-data 做 str_replace(["\n", "\r"], "", $receipt_data) 清洗
• 绝对不要对 +、/、= 做 URL 解码或替换（iOS base64 不用 URL-safe 变种）
• 长度校验不能只看 strlen，要先清洗再判断：if (strlen($receipt_data) （真实票据一般 >1000 字符）

如何自动判断沙盒 or 正式环境？别硬编码开关

Apple 要求：沙盒票据只能发给沙盒地址验证，正式票据只能发给正式地址。但 iOS 客户端不告诉你当前是哪个环境，也不能靠 is_test 参数（它不可靠，且新版 iOS 已弃用）。

• 正确做法：先用正式地址 https://buy.itunes.apple.com/verifyReceipt 请求一次
• 如果返回 status === 21007（沙盒票据打正式地址），立刻用沙盒地址重试
• 如果返回 status === 21008（正式票据打沙盒地址），说明客户端配置错，应记录日志并拒绝
• 别用设备 UDID、Bundle ID 或 IP 判断环境 —— 全部无效且违反 Apple 政策

验签成功后怎么提取关键业务字段？重点看 in_app 数组

验签返回的 JSON 中，有效购买信息全在 receipt['in_app'] 数组里（即使单次购买也是数组），不是顶层 receipt 字段。常见误操作是直接读 $data['receipt']['product_id'] —— 会报错或取空。

• transaction_id 是唯一支付 ID，必须存库用于防重（Apple 允许同一票据多次提交，但 transaction_id 绝对唯一）
• original_transaction_id 对订阅首次购买很重要，续订时保持一致
• purchase_date_ms 是毫秒时间戳，PHP 用 (int)($item['purchase_date_ms'] / 1000) 转为标准时间
• 检查 quantity 字段，避免客户端恶意改包传高数量（如买 1 次传 quantity=999）

v2 订阅通知（JWS）和传统 receipt 验证完全不是一回事

如果你接入的是 Apple 订阅服务（尤其是自动续期订阅），2025 年起 Apple 强制要求使用 v2 通知（JWS 格式），它不是 JSON，而是三段 base64 字符串（header.payload.signature），需用 JWT 库 + 苹果根证书验签，和老的 verifyReceipt 接口互不兼容。

• v2 通知是 Apple 主动 POST 到你服务器的 Webhook（不是客户端回调），路径如 /api/apple/notify
• 必须验证 $header['x5c'][0] 是否匹配苹果官方 AppleRootCA-G3.pem（不是系统自带证书）
• 不能用 json_decode 直接解 payload —— 必须用 JWT::decode($jws, $public_key, ['RS256'])，否则验签失败
• 老项目还在用 v1 receipt 验证的，只要没上订阅功能，可暂不升级；但凡有订阅，v1 就无法处理退款、续订、过期等事件

最常被忽略的一点：Apple 的 verifyReceipt 接口响应中，status === 0 只代表票据格式合法，不代表「这笔钱已到账」—— 你还得比对 bundle_id、product_id、transaction_id 是否与你订单一致，否则黑产可复用他人票据完成虚假支付。

# php  # js  # json  # 编码  # app  # 苹果  # ios  # apple  # 状态码  # 退款  # strlen  # if  # 字符串  # int  # 接口  # 事件  # this  # https  # 客户端  # 的是  # 如果你  # 还在  # 尤其是  # 首次  # 换行符  # 不代表  # 只代表  # 很重要 

相关文章： 微信网站制作公司有哪些,民生银行办理公司开户怎么在微信网页上查询进度？  建站之星伪静态规则如何正确配置？  网站制作网站,深圳做网站哪家比较好？  制作表格网站有哪些,线上表格怎么弄？  商务网站制作工程师,从哪几个方面把握电子商务网站主页和页面的特色设计？  我的世界制作壁纸网站下载,手机怎么换我的世界壁纸？  专业公司网站制作公司,用什么语言做企业网站比较好？  浅谈Javascript中的Label语句  电视网站制作tvbox接口,云海电视怎样自定义添加电视源？  网站插件制作软件免费下载,网页视频怎么下到本地插件？  如何快速生成可下载的建站源码工具？  北京营销型网站制作公司,可以用python做一个营销推广网站吗？  电商网站制作公司有哪些,1688网是什么意思？  制作电商网页,电商供应链怎么做？  javascript中对象的定义、使用以及对象和原型链操作小结  如何在建站宝盒中设置产品搜索功能？  ,南京靠谱的征婚网站？  车管所网站制作流程,交警当场开简易程序处罚决定书，在交警网站查询不到怎么办？  定制建站策划方案_专业建站与网站建设方案一站式指南  如何在IIS中新建站点并配置端口与IP地址？  表情包在线制作网站免费,表情包怎么弄？  如何使用Golang安装API文档生成工具_快速生成接口文档  如何通过FTP空间快速搭建安全高效网站？  移民网站制作流程,怎么看加拿大移民官网？  洛阳网站制作公司有哪些,洛阳的招聘网站都有哪些？  学校建站服务器如何选型才能满足性能需求？  小自动建站系统：AI智能生成+拖拽模板，多端适配一键搭建  极客网站有哪些,DoNews、36氪、爱范儿、虎嗅、雷锋网、极客公园这些互联网媒体网站有什么差异？  如何在企业微信快速生成手机电脑官网？  如何用IIS7快速搭建并优化网站站点？  网页设计网站制作软件,microsoft office哪个可以创建网页？  建站之星免费版是否永久可用？  官网网站制作腾讯审核要多久,联想路由器newifi官网  浙江网站制作公司有哪些,浙江栢塑信息技术有限公司定制网站做的怎么样？  购物网站制作公司有哪些,哪个购物网站比较好？  Swift中循环语句中的转移语句 break 和 continue  宝塔面板创建网站无法访问？如何快速排查修复？  高性价比服务器租赁——企业级配置与24小时运维服务  历史网站制作软件,华为如何找回被删除的网站？  XML的“混合内容”是什么 怎么用DTD或XSD定义  济南网站建设制作公司,室内设计网站一般都有哪些功能？  ,怎么用自己头像做动态表情包？  如何用y主机助手快速搭建网站？  如何在IIS7中新建站点？详细步骤解析  如何零基础在云服务器搭建WordPress站点？  专业网站建设制作报价,网页设计制作要考什么证？  制作网站的公司有哪些,做一个公司网站要多少钱？  北京建设网站制作公司,北京古代建筑博物馆预约官网？  c# Task.Yield 的作用是什么 它和Task.Delay(1)有区别吗  交易网站制作流程,我想开通一个网站，注册一个交易网址，需要那些手续？