如何为Laravel项目申请并使用2checkout沙箱环境？

沙箱测试环境申请步骤 #

• 登录你的2Checkout商家后台，在顶部导航栏找到*Configuration（配置）分类，下拉选择Sandbox（沙箱）*选项即可进入沙箱管理页
• 点击页面内的Create Sandbox Account按钮，按提示填写测试商家账号的基础信息，包括测试邮箱、密码、预设测试交易额度，提交后1-2分钟即可完成账号创建
• 申请完成后你会获得专属的沙箱测试商户号、公钥、私钥，所有测试环境的API请求都需要使用这组凭证，不要和正式环境凭证混用

沙箱环境核心注意事项 #

• 沙箱环境仅支持测试用途，所有交易不会产生真实资金流转
• 测试用的信用卡卡号可直接使用2Checkout官方提供的测试卡段，无需绑定真实银行卡，测试卡的有效期、CVV填写未来的有效日期即可
• 沙箱环境的回调通知地址需要在沙箱后台单独配置，不能复用正式环境的回调配置

Laravel项目接入步骤 #

• 首先通过composer安装官方适配的SDK包，执行命令：composer require 2checkout/2checkout-php
• 在项目的.env文件中新增沙箱凭证配置项：

  2CHECKOUT_SANDBOX_MERCHANT_ID=你的沙箱商户号
  2CHECKOUT_SANDBOX_PUBLIC_KEY=你的沙箱公钥
  2CHECKOUT_SANDBOX_PRIVATE_KEY=你的沙箱私钥
  2CHECKOUT_SANDBOX_MODE=true
  

• 新建支付服务类，初始化SDK时指定沙箱模式，示例代码片段：

  <?php
  
  namespace App\Services;
  
  use Twocheckout;
  use Twocheckout_Charge;
  
  class TwoCheckoutService
  {
      public function __construct()
      {
          Twocheckout::privateKey(config('services.2checkout.sandbox_private_key'));
          Twocheckout::sellerId(config('services.2checkout.sandbox_merchant_id'));
          Twocheckout::sandbox(config('services.2checkout.sandbox_mode'));
      }
  
      public function createCharge($orderData)
      {
          try {
              return Twocheckout_Charge::auth($orderData);
          } catch (\Exception $e) {
              return ['error' => $e->getMessage()];
          }
      }
  }
  

• 支付回调处理需要在路由中新增POST回调地址，关闭CSRF验证后，按2Checkout回调规则校验签名，确认交易状态后更新本地订单状态即可

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