klarna / kco_rest

此包已被废弃且不再维护。没有建议的替代包。

Klarna Checkout PHP SDK

v4.2.3 2020-02-14 09:31 UTC

README

Packagist Version Build Status Coverage Status

SDK 废弃警告和停用

尊敬的社区,您目前正在查看的 SDK 已被废弃。以下是停用相关的详细信息

  • 我们计划在 2020 年 6 月 1 日(01/06/20)存档此仓库
  • 直到 2020 年 11 月 1 日(01/11/20),将修复最新发布版本中发现的严重安全问题。在此日期之后,将停止所有支持。
  • 除了上述修复之外,从 2020 年 4 月 20 日(20/04/2020)起,将不再进行新的构建。

解决方案

我们正在以 Swagger / OAS v2 格式提供 Klarna REST API 定义文件,位于 Klarna API 参考 部分,在 Klarna 开发者门户 上。这些将随着 API 的演变而定期更新。您可以使用像 https://swagger.org.cn/tools/swagger-codegen/ 这样的工具来生成您自己的 SDK、客户端库等。

现在购物。以后付款。

今天在您喜欢的商店购物,并体验 Klarna 的自由延迟付款。

入门

SDK 覆盖了 Klarna API 的全部:[Klarna API](https://developers.klarna.com/api/)

先决条件

API 凭证

在获取生产账户之前,您可以获取一个游乐场账户。在此注册,以便在上线前测试您的 SDK 集成

PHP SDK 安装和使用

通过 Composer 安装

要从中央 Composer 仓库安装 PHP SDK,请使用 composer

composer require klarna/kco_rest

强烈建议在安装 SDK 时使用版本标签。

composer require klarna/kco_rest:1.2.3.4

有关 PHP SDK 包的详细信息以及可用的版本列表,请在此处查看:[Klarna/kco_rest](https://packagist.org.cn/packages/klarna/kco_rest)

使用 Composer 自动加载器将 SDK 包含到您的 PHP 文件中

<?php

require('vendor/autoload.php');

手动安装

要手动安装 PHP SDK,您需要将仓库克隆到您机器上的任何文件夹

git clone git@github.com:klarna/kco_rest_php.git /path/to/some/folder/kco_rest_php

使用SDK自动加载器将SDK包含到您的PHP文件中

<?php

require('/path/to/some/folder/kco_rest_php/src/autoload.php');

⚠️警告:使用手动安装的SDK需要您使用CURLTransport实例发送HTTP请求。

了解更多关于如何使用HTTP传输的信息

文档和示例

Klarna API文档:https://developers.klarna.com/api/
SDK参考:https://klarna.github.io/kco_rest_php/

示例文件可以在docs/目录中找到。
更多文档可以在https://developers.klarna.com找到。

日志记录和调试

PHP SDK将信息记录到STDOUT/STDERR。要启用调试模式,设置DEBUG_SDK环境变量

$ DEBUG_SDK=true php <your_program.php>

$ export DEBUG_SDK=1
$ php <your_program.php>

启用调试模式的另一种方法是,在您的脚本中定义DEBUG_SDK

<?php
// some code here
define('DEBUG_SDK', true);
// some code here

请注意,SDK仅检查是否定义了DEBUG_SDK!这意味着您将通过使用define('DEBUG_SDK', false);export DEBUG_SDK=no来查看调试信息

有关DEBUG_SDK标志的更多信息,请参阅:https://github.com/klarna/kco_rest_php/issues/32

输出将如下所示

DEBUG MODE: Request
>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>
    GET : https://api.playground.klarna.com/customer-token/v1/tokens/TOKEN
Headers : {"User-Agent":["Library\/Klarna.kco_rest_php_3.1.0 (Guzzle\/6.3.3; curl\/7.54.0) OS\/Darwin_17.5.0 Language\/PHP_5.6.37"]}
   Body :

DEBUG MODE: Response
<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<
Headers : {"Content-Type":["application\/json"],"Date":["Wed, 15 Aug 2018 15:55:53 GMT"],"Klarna-Correlation-Id":["ABC-123"],"Server":["openresty"],"Content-Length":["62"],"Connection":["keep-alive"]}
   Body : {
     "status" : "ACTIVE",
     "payment_method_type" : "INVOICE"
   }

问题和反馈

如果您对此产品或实现有任何疑问,请创建一个问题: https://github.com/klarna/kco_rest_php/issues/new/choose

如果您对集成有任何问题,请使用官方Klarna联系表单(https://klarna.com)。

如何贡献

在Klarna,我们致力于实现我们产品可能达到的最高质量。因此,如果您想贡献,请遵循以下指南。

要贡献,必须满足以下标准

  • 关于变更内容和原因的描述
  • 拉取请求应实现包装的变更
  • 所有代码和文档都必须遵循PSR-2标准
  • 新功能和错误修复必须有相应的单元测试
    • 正面测试
    • 负面测试
    • 边界测试(如果可能)
    • 决策覆盖率不低于90%
  • 所有测试应通过

许可证

Klarna Checkout REST PHP SDK在Apache许可证,版本2.0下授权。