This commit is contained in:
2026-09-15 10:35:56 +08:00
commit 782f8ea7aa
4086 changed files with 631288 additions and 0 deletions
@@ -0,0 +1,39 @@
# Esun_OceanpaymentKlarna
Magento 2 钱海 Oceanpayment Klarna 独立支付模块。模块使用 Oceanpayment Hosted Checkout,
不采集消费者的 Klarna 凭据,也不依赖或修改 `Esun_Oceanpayment`。
## 配置
后台路径:`Stores > Configuration > Sales > Payment Methods > 钱海支付 - Klarna`。
分别在网站范围配置测试和正式环境对应的 `Account`、`Terminal`、`Secure Code`。后台仍可保存钱海提供的 `Key`,但 Klarna Hosted Checkout 不会把它发送到支付接口。
凭据通过 Magento 加密配置保存,请勿写入源码或提交到 Git。
沙盒测试时启用“沙盒模式”;上线时关闭沙盒模式即可自动使用正式凭据。支付方式代码固定为
`Klarna`,无需在后台修改。
默认只向 Oceanpayment 文档列出的 Klarna 国家开放。实际国家、币种及业务类型仍以对应钱海
终端的开通范围为准。
## 支付流程
1. Magento 创建 `pending_payment` 订单;
2. 模块生成 Klarna 必需的 `itemList`,并验证明细金额等于订单总额;
3. 服务端调用 Oceanpayment `sendTrade`;
4. 用户跳转至 Oceanpayment/Klarna 完成支付;
5. 独立的同步返回和异步通知完成验签及幂等处理;
6. `payment_status=-1` 进入支付审核,`payment_status=1` 时登记收款并开票。
当前模块兼容由 Oceanpayment 开通的 Auto Capture。若商户使用 Manual Capture,需要另外接入
Oceanpayment 的预授权完成/撤销接口后再启用生产支付。
## 安装
```bash
php bin/magento module:enable Esun_OceanpaymentKlarna
php bin/magento setup:upgrade
php bin/magento cache:flush
```
生产模式还需重新执行 DI 编译和静态资源部署。