klarna / kco_rest
Klarna Checkout PHP SDK
Requires
- php: >=5.5.0
- guzzlehttp/guzzle: ~6.0
Requires (Dev)
- apigen/apigen: 4.1.*
- klarna/apigen-theme: 2.1.0
- php-coveralls/php-coveralls: ^2.1
- phploc/phploc: 2.0.*
- phpmd/phpmd: 2.1.*
- phpunit/phpunit: >=4.0.0, <6.0
- sebastian/phpcpd: 2.0.*
- squizlabs/php_codesniffer: 1.5.*
This package is auto-updated.
Last update: 2020-04-22 08:05:05 UTC
README
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 集成
- https://playground.eu.portal.klarna.com/developer-sign-up - 欧洲国家
- https://playground.us.portal.klarna.com/developer-sign-up - 美国
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下授权。