使用Paytm Wallet集成Paytm支付网关出现Undefined index: TXNID错误
Paytm集成触发
Undefined index: TXNID 问题排查与解决 场景说明
在Laravel项目中完成Paytm支付的发起逻辑、回调逻辑与对应路由配置后,支付流程触发回调时,抛出Undefined index: TXNID报错。
相关现有代码
发起支付的控制器逻辑
public function pay() { $payment = PaytmWallet::with('receive'); $payment->prepare([ 'order' => 25, // 从购物车获取的订单ID 'user' => 'Cust_id_12', // 用户ID 'mobile_number' => 7277407765, // 客户手机号码 'email' => 'abx@gmail.com', // 用户邮箱地址 'amount' => 200.00, // 以INR为单位的待支付金额 'callback_url' => 'http://172.18.0.4:8006/payment/status' // 回调地址 ]); return $payment->receive(); }
支付回调的控制器逻辑
/** * 获取支付信息 * @return Object */ public function paymentCallback() { $transaction = PaytmWallet::with('receive'); $response = $transaction->response(); if($transaction->isSuccessful()){ }else if($transaction->isFailed()){ // 交易失败 }else if($transaction->isOpen()){ // 交易待处理/进行中 } $transaction->getResponseMessage(); // 可获取可用的响应消息 $transaction->getOrderId(); // 获取订单ID $transaction->getTransactionId(); // 获取交易ID }
报错核心原因
该报错是PaytmWallet SDK在解析回调入参时,直接尝试从请求数组中读取TXNID下标,但对应值不存在导致的PHP未定义下标错误,常见触发源包括:
- 回调地址使用内网私有IP
http://172.18.0.4:8006,Paytm的公网服务器无法访问到你的本地服务,根本不会传递完整的交易回调参数到你的接口 - 回调路由被Laravel的CSRF防护、Auth鉴权等中间件拦截,第三方Paytm的请求不会携带你的站点CSRF token,会直接返回419拦截响应,根本走不到参数解析流程
- 路由绑定关系错误:配置的回调路径
/payment/status没有正确绑定到paymentCallback方法,甚至没有在web.php中注册对应路由 - 接入配置不匹配:Paytm的Merchant ID、密钥、接入模式(沙箱/生产)和SDK配置不一致,导致Paytm返回的响应结构和SDK预期不符,缺少核心的
TXNID字段
解决步骤
- 本地开发阶段使用内网穿透工具将本地服务映射为公网可访问的地址,替换掉代码里的内网IP回调地址,确保Paytm服务器可以正常访问到你的回调接口
- 在Laravel的
VerifyCsrfToken中间件中,将回调路径加入排除名单,跳过CSRF校验放行Paytm的第三方请求 - 核对
web.php中的路由配置,确保/payment/status路径的路由直接绑定paymentCallback方法,没有多余的鉴权中间件挂载 - 调试阶段打印回调接口接收到的全量请求参数,确认实际入参结构,核对当前安装的PaytmWallet SDK版本和Paytm接入要求是否匹配
- 业务代码中不要直接从原始请求数组读取
TXNID字段,优先使用SDK提供的getTransactionId()方法获取交易ID,SDK内置参数存在性校验,可规避直接读数组下标的未定义报错
内容的提问来源于stack exchange,提问作者Athar Marfatia
相关产品推荐
相关产品推荐

