基于PHP的Paynamics支付网关集成签名验证失败问题求助

看起来你踩了Paynamics支付网关最常见的坑之一——签名验证失败，我之前集成的时候也遇到过类似问题，给你几个针对性的排查和解决方向：

1. 核心问题：签名生成规则不匹配 #

Paynamics的签名验证严格依赖参数顺序、参数完整性、加密算法这三点，只要有一点不对就会触发验证失败。首先你要确认是否严格按照官方文档的要求生成签名：

• 必须使用指定的参数列表（比如mid、requestid、amount、currency、responseid、ipaddress等，具体以Paynamics当前API文档为准）
• 参数必须按文档规定的固定顺序拼接成字符串（不能乱序，比如不能把requestid放在mid前面）
• 加密算法必须是HMAC-SHA256（大部分Paynamics接口用这个，少数可能有差异，务必核对文档）

2. 检查你的签名生成代码（关键！） #

从你提供的代码片段看，只定义了部分参数，但没有签名生成的逻辑，这大概率是问题所在。给你一个PHP示例参考（你可以对应调整）：

// 假设你的商户Key
$_merchantKey = "your_merchant_key_here";

// 按Paynamics文档要求的顺序整理必填参数
$signParams = [
    $_mid,
    $_requestid,
    $_POST['amount'], // 注意：金额必须是标准格式，比如100.00（不能是整数100）
    "PHP", // 交易货币，根据实际情况调整
    $_responseid,
    $_ipaddress // 这里建议用真实的用户公网IP，而不是内网IP
];

// 把参数拼接成无分隔符的字符串
$stringToSign = implode('', $signParams);

// 生成HMAC-SHA256签名
$signature = hash_hmac('sha256', $stringToSign, $_merchantKey);

生成的$signature必须作为隐藏表单字段（比如name="signature"）和其他交易参数一起提交到Paynamics的支付URL。

3. 验证参数细节 #

• 金额格式：必须保留两位小数，比如150.00而不是150，Paynamics对金额精度要求很高
• RequestID唯一性：你用substr(uniqid(), 0, 13)生成的ID要确保每次交易唯一，且符合Paynamics的长度要求（一般是13-32位，核对文档）
• IP地址：如果你的测试环境用的是内网IP（比如192.168.10.1），虽然后台能保存交易，但部分接口可能要求公网IP，建议换成真实的公网IP测试
• 参数大小写：所有参数名和值的大小写必须和文档一致（比如currency不能写成Currency）

4. 对比后台参数和本地生成的签名 #

登录Paynamics后台找到该失败交易，查看系统接收到的所有参数，然后用这些参数完全复制到本地重新生成签名，对比和你提交的签名是否一致。如果不一致，说明你提交时的参数和生成签名时用的参数有差异（比如金额被截断、参数漏传等）。

5. 用工具辅助验证 #

可以用在线HMAC-SHA256工具，把你拼接好的$stringToSign和商户Key输入进去，看生成的签名和你代码生成的是否一致。如果工具生成的和代码不一样，说明你的签名生成逻辑有问题。

最后再提醒一句：一定要严格对照Paynamics的最新官方文档，不同的支付接口（比如Redirect API、Direct API）的签名规则可能有细微差别，参数顺序绝对不能错！

内容的提问来源于stack exchange，提问作者nikko