Files
esun3d/app/code/Esun/OceanpaymentKlarna/README_CN.md
T
2026-09-15 10:35:56 +08:00

40 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 编译和静态资源部署。