crasphb/kco_rest_xms

官方Klarna REST PHP SDK

v5.0.0 2022-10-17 07:30 UTC

This package is auto-updated.

Last update: 2024-09-29 06:25:57 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)起,将不会有新的构建。

解决方案

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

立即购物。延期付款。

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

入门

SDK涵盖了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包的详细信息以及可用版本的列表,请在此处查看: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传输的更多信息,请参阅如何使用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 标志的更多信息,请参阅此处: klarna#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 下授权。