苹果支付金额校验需严格比对in_app中price与本地订单金额、绑定product_id价格表、检查price_change_tag、验证bundle_id一致性、确保transaction_id与order_id原子绑定。

如果您在服务端接收到苹果支付返回的收据凭证后,发现订单金额与预期不符,可能是由于客户端未正确传递商品ID、服务端未比对苹果返回的product_id与价格映射、或未校验in_app数组中对应交易的实际金额字段。以下是多种校验苹果支付金额的PHP实现方法:
一、校验收据解析后的in_app数组内actual_amount字段
苹果验证接口返回的JSON响应中,in_app数组每个元素包含交易明细,其中original_transaction_id、product_id和transaction_amount(部分版本为price或需从currency+price组合推导)是关键字段。必须提取该笔交易对应的实际支付金额,并与本地订单金额比对。
1、使用json_decode解析苹果返回的验证响应,确保获取到in_app数组。
2、遍历in_app数组,查找与当前订单所用product_id完全匹配的条目。
立即学习“PHP免费学习笔记(深入)”;
3、读取该条目中的price字段(单位为最小货币单位,如USD为美分),并结合currency字段确认币种。
4、将本地订单金额按相同币种与最小单位换算后,与price值进行严格相等比较(非浮点数比较,应转为整型)。
二、绑定product_id与预设价格表进行双向校验
服务端必须维护一份与App Store Connect中配置完全一致的商品ID与价格映射表(含币种)。该表不可由前端传入,须硬编码或从可信配置中心加载,防止被篡改。校验时需同时验证product_id存在性及对应价格一致性。
1、定义本地价格映射数组,例如:$priceMap = ['com.app.coins100' => ['amount' => 99, 'currency' => 'USD']]。
2、从苹果收据解析结果中提取product_id和currency字段。
3、检查$product_id是否存在于$priceMap中,且$priceMap[$product_id]['currency']与收据中currency完全一致。
4、将$priceMap[$product_id]['amount']与收据中对应交易的price字段作整型全等判断。
三、校验original_purchase_date_ms与price_change_tag防重复/篡改
针对订阅类商品,苹果可能在价格变更后允许用户保留旧价格。此时收据中会包含price_change_tag字段,且original_purchase_date_ms可用于识别首次购买时间。若业务要求强制使用最新定价,则需拒绝含price_change_tag且price不等于当前配置价格的交易。
1、检查收据in_app条目中是否存在price_change_tag字段(非空字符串)。
2、若存在,读取original_purchase_date_ms并转换为日期,判断是否早于当前价格生效时间。
3、若早于且本地价格已更新,则拒绝该交易金额,视为无效定价,不执行发货逻辑。
四、比对receipt.bundle_id与应用标识一致性
bundle_id是苹果分配给应用的唯一标识,若收据中bundle_id与当前服务所归属的应用不一致,说明该收据可能来自其他应用或伪造,其内部金额字段不可信,必须拦截。
1、从苹果验证响应的根级receipt对象中提取bundle_id字段。
2、与服务端预设常量IOS_BUNDLE_ID(如'com.example.app')进行字符串全等比较。
3、若不一致,立即终止后续金额校验流程,返回错误码21003或自定义非法应用标识错误。
五、校验transaction_id与本地订单号的原子绑定关系
苹果返回的transaction_id是全局唯一交易标识,必须与服务端生成的order_id在数据库层面建立强关联。金额校验前,需确认该transaction_id尚未被其他订单使用,且对应order_id的状态为“待支付”,防止金额被重复提交或错配。
1、根据请求中携带的transaction_id查询数据库中是否存在已处理记录。
2、若存在且status非“已取消”,则拒绝本次请求,防止金额覆盖或双花。
3、若不存在,再执行订单号(order_id)查库,确认其status为“待支付”且product_id与收据中一致。
4、仅当上述两项均通过,才进入金额数值比对环节。











