OpenCart

OpenCart 接入 imsafu 支付非常简单，我们将为您介绍如何安装与配置。

插件下载

请点击 opencart_imsafu_extension.ocmod.zip 下载插件。

插件上传、安装以及激活

1. 登录到 OpenCart 后台，在左侧主菜单中找到 Extensions -> Installer -> Upload，然后选择你在上一步中下载的插件 opencart_imsafu_extension.ocmod.zip。

   

2. 选中插件后，点击 Install 开始安装。

   

3. 安装完成后，在左侧主菜单中找到 Extensions -> Extensions -> Choose the extension type -> Payments，找到 imsafu Payment 点击对应 Install 来激活插件。

   

插件配置以及说明

在左侧主菜单中找到 Extensions -> Extensions -> extension type下拉菜单选中Payments，找到 imsafu Payment 点击对应 Edit 进入插件配置页面。

编辑完成后，点击右上角的 Save 按钮进行保存。

参数说明：

1. Enable/Disable: 该选项决定是否处理付款流程（可在不禁用插件的情况下暂停处理付款流程）。
2. Test Mode: 开启此模式后，您可以使用测试网络和测试币进行支付测试。（注意：在生产环境下，务必保持关闭）
3. Receiver Wallet Address: 您可以使用钱包地址或交易所的充值地址。
4. API Key: 请到 imsafu 官网 点击 Join Waitlist 填写表单来申请 API Key。(如果开启 Test Mode，此处可不填写)
5. Currency: 默认情况下，美元是用于支付的货币。如果您选择了其他货币（如人民币），系统将根据当前汇率自动把它转换为美元。
6. Approved Status: 设置付款成功 的订单状态，选择 Processing 即可，您可以根据实际情况调整。
7. Failed Status: 设置 付款失败 的订单状态，选择 Failed 即可，您可以根据实际情况调整。
8. Geo Zone: 该参数暂未启用，保持默认即可。
9. Status: 该选项决定是否启用当前的插件。
10. Sort Order: 插件排序，填写 1 即可，您可以根据实际情况调整。

修改 Session Samesite Cookie 设置

1. 配置完成后，请修改 Session Samesite Cookie 设置，在左侧主菜单中找到 System -> Settings -> Server -> Session Samesite Cookie，默认值为 Strict， 会导致支付完成页面重定向后丢失登录状态， 需要修改为 Lax 或 None， 点击 Save 进行保存。

   

测试模式说明

1. 在 Test Mode 开启的情况下，不需要填写 API Key。
2. 测试币得领取：USDC 官方水龙头。
3. 请注意，切勿在生产环境开启 Test Mode。