Razorpay Laravel集成问题：无法获取客户已保存卡片的Token

问题场景 #

我需要在客户支付订单时保存其卡片信息，执行流程如下：

• 客户从App下单后，服务器创建客户及订单；
• App端发起支付时，Payload中传入"save": true参数；
• 支付验证阶段，通过客户ID从服务器获取Token，但目前调用接口返回的tokens为NULL。

代码片段 #

$api = new Api($razorpayKey, $razorpaySecret);
$tokens =  $api->customer->fetch($user->pg_cust_id)->tokens()->all();

Log::debug("tokens:- " . json_encode($tokens));

排查与解决步骤 #

1. 确认save参数格式与传递
   确保App端支付请求的Payload中，save是布尔值true（而非字符串"true"），且该参数被正确包含在Razorpay的支付请求体内。参数格式错误会直接导致卡片无法被保存。

2. 验证客户ID有效性
   检查$user->pg_cust_id是否为Razorpay返回的官方客户ID，而非本地系统自定义ID。可以登录Razorpay后台，在客户列表中搜索该ID，确认客户存在且是否有已保存的卡片记录。

3. 确认支付状态
   只有成功完成的支付，且携带save: true参数时，卡片Token才会被生成并关联到客户。如果支付失败、被取消或处于待验证状态，不会产生Token。

4. 更新Razorpay库版本
   检查当前使用的Laravel Razorpay库版本，旧版本可能存在API调用兼容性问题。执行composer update razorpay/razorpay更新到最新稳定版后重试。

5. 直接调用原生API排查
   绕过Laravel封装库，用Postman或curl直接调用Razorpay的GET /customers/{customer_id}/tokens接口，传入正确的API密钥。如果接口返回空数组，说明卡片未被成功保存；如果返回数据，则是Laravel库的调用逻辑问题。

6. 检查账户权限
   确认你的Razorpay账户已开启卡片保存功能，部分测试账户或受限账户可能无法使用该特性，可在Razorpay后台设置中查看相关权限。

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