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

1.7 KiB
Raw Blame History

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 的预授权完成/撤销接口后再启用生产支付。

安装

php bin/magento module:enable Esun_OceanpaymentKlarna
php bin/magento setup:upgrade
php bin/magento cache:flush

生产模式还需重新执行 DI 编译和静态资源部署。