PHP对接Worldpay托管集成:测试环境回调缺失MAC参数及MAC Secret使用问题
问题排查与解决方案
核心异常根因
- 你当前自定义回调URL的配置方式,直接导致拿不到平台返回的业务参数:Worldpay托管支付的自定义结果URL跳转逻辑为,你在支付请求XML中传入哪个完整URL字符串,平台就会在支付完成后直接302跳转至该地址,不会自动向你提供的URL追加任何平台侧的查询参数。
你之前在URL里提前写死了?paymentStatus=success这类自定义参数,等于告诉平台直接跳转到这个固定带参数的地址,平台自然不会额外追加orderKey、paymentAmount、mac2这类文档说明的回传参数,这和测试/生产环境没有关系。 - 现有回调代码存在逻辑bug:你写的判断语句
if( $_SESSION['paymentStatus'] = 'success'; )使用了单等号做赋值操作而非双等号比较,且语句多了分号,会导致条件判断永远为真,无论实际支付结果是什么,都会触发成功页面跳转。
正确配置步骤
- 调整支付请求XML中的自定义结果URL配置,移除所有提前写死的自定义查询参数,让所有支付状态的回调统一指向同一个无参数的回调路径:
// 原错误写法:URL中提前嵌入自定义参数,平台会直接跳转该固定地址,不附带回传业务参数 // $successURL = urlencode( "/callback.php?paymentStatus=success"); // $failureURL = urlencode( "/callback.php?paymentStatus=failure" ); // $pendingURL = urlencode( "/callback.php?paymentStatus=pending" ); // $errorURL = urlencode( "/callback.php?paymentStatus=error" ); // 正确写法:所有状态回调统一指向无参数的回调路径,平台跳转时会自动追加上全部业务参数与MAC签名 $successURL = urlencode( "/callback.php" ); $failureURL = urlencode( "/callback.php" ); $pendingURL = urlencode( "/callback.php" ); $errorURL = urlencode( "/callback.php" ); - 修改后发起测试支付,完成支付流程后会看到平台跳转至
/callback.php时,URL上自动附带了全部要求的回传参数,包括订单标识、支付金额、币种、真实支付状态、MAC校验值,此时在callback.php中打印$_GET就能拿到完整参数列表。
MAC安全校验实现方式
- 拿到回传的全部GET参数后,按照Worldpay规定的字段拼接顺序,将参与签名的字段值与你的
MAC Secret做固定规则的字符串拼接,对拼接后的字符串计算SHA256哈希值。 - 将计算得到的哈希值与回传参数中的
mac2值做严格相等比对:- 比对一致:说明请求确实来自Worldpay平台,未被伪造或篡改,可按回传的支付金额、币种、订单标识更新本地订单状态
- 比对不一致:直接丢弃该请求,不执行任何订单状态变更、不向前端展示支付结果提示
- 绝对不能信任前端通过URL传递的、未经过MAC校验的支付状态值,这类参数可被轻易篡改,存在资金风险。
补充说明
- Worldpay测试环境完全支持参数回传与MAC校验,不存在“测试环境不返回签名参数”的限制,只要调整URL配置即可正常获取回传值。
- 不建议将支付状态存入Session后再跳转前端展示,这种逻辑容易出现多标签页操作、Session过期导致的状态错乱,建议在回调接口完成MAC校验、订单状态更新后,再生成携带安全状态标识的前端跳转链接,直接引导用户到结果页面。
内容的提问来源于stack exchange,提问作者TheOrdinaryGeek
相关产品推荐
相关产品推荐

