PHP无法直接触发App Store部分退款，需通过App Store Server API验证交易、查询历史、本地标记退款、配置通知回调并生成内部退款凭证。
如果您在苹果支付（Apple In-App Purchase）场景中需要对已成功的交易执行部分退款，PHP 本身无法直接触发 App Store 的退款操作，但可通过服务器端与 App Store Server API 配合完成验证、状态同步及业务侧部分退款逻辑。以下是实现该目标的具体步骤：
一、获取原始交易凭证并验证收据
部分退款的前提是确认原始购买的有效性与当前交易状态，需使用 Apple 提供的收据验证接口确认订单真实性及最新状态。
1、从客户端获取 transactionReceipt 或 signedTransactionInfo（iOS 15+ 推荐使用 signedTransactionInfo）。
2、将 receipt-data 进行 Base64 编码（若未编码），构造 JSON 请求体，向 https://api.storekit.itunes.apple.com/inApps/v1/transactions/{transactionId} 发送 GET 请求，携带 bearer token 认证头。
立即学习“PHP免费学习笔记（深入）”；
3、解析响应中的 status 字段，status 为 0 表示收据有效，且需检查 latestReceiptInfo 中的 originalTransactionId 和 productId 是否匹配原始订单。
二、调用 App Store Server API 查询订单历史
为支持部分退款，必须确认该交易是否处于可退款窗口期（通常为订单创建后 90 天内），且未被全额退款或取消，需通过历史交易查询接口获取完整生命周期记录。
1、使用原始 transactionId 向 https://api.storekit.itunes.apple.com/inApps/v1/history/{originalTransactionId} 发起 GET 请求。
2、遍历 response 中的 data 数组，查找类型为 "REFUND" 的事件，若已存在 REFUND 类型事件，则不可再次发起部分退款。
3、提取 latestReceiptInfo 中的 purchaseDate 和 expiresDate，确认该订阅或消耗型项目仍处于有效期内（适用于自动续订订阅的部分周期退款场景）。
三、在业务系统中执行本地部分退款标记
Apple 不提供“部分金额”退款的直接 API，因此需在 PHP 服务端自行维护退款比例、剩余权益及用户账户余额调整逻辑，确保与 Apple 状态一致。
1、根据订单原始金额（如 .99）和申请退款金额（如 .99），计算退款占比 精确到小数点后两位，避免浮点误差。
2、更新数据库中该 transaction_id 对应的 refund_status 字段为 "PARTIAL"，同时写入 refund_amount 和 refund_timestamp。
3、若为订阅型商品，需按比例折算剩余服务天数，并在用户账户中延长等效有效期（例如：原 30 天订阅退 1/3，则额外增加 10 天）。
四、向 App Store 提交退款通知回调配置
Apple 不主动推送部分退款事件，但可通过 Server Notification 配置接收退款状态变更，需确保 PHP 后端能正确解析并处理 type=REFUND 的通知。
1、在 App Store Connect 中配置服务器通知 URL，启用 version 2 格式。
2、在 PHP 接口处校验 HTTP 头 X-Apple-Jwt-Signature，并使用 Apple 提供的公钥验证 JWT payload 签名。
3、解析 payload 中的 notificationType，当 notificationType 为 "REFUND" 时，提取 subType 字段判断是否为 "FULL_REFUND" 或 "PARTIAL_REFUND"，并同步更新本地订单状态。
五、生成并返回客户端可识别的退款确认凭证
由于 Apple 不返回部分退款的唯一凭证 ID，PHP 必须生成内部退款单号并与原始 transactionId 绑定，供客户端核对与展示。
1、使用 uniqid() 与原始 transactionId 拼接生成 refund_order_id，格式为 "REF-{transactionId}-{timestamp}"。
2、将该 refund_order_id、退款金额、生效时间、对应服务权益说明等信息加密签名，生成 client_token。
3、返回给客户端的 JSON 响应中必须包含 refund_order_id 和 status: "partial_refunded"，且不得暴露任何 Apple 内部字段（如 signedTransactionInfo）。
