luxplus/kco_rest

官方Klarna REST 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)起,将不会有新的构建。

解决方案

我们正在将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传输的更多信息,请参阅

文档和示例

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](https://github.com/klarna/kco_rest_php/issues/new/choose)

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

如何贡献

在 Klarna,我们致力于为我们的产品提供尽可能高的质量。因此,如果您希望做出贡献,请遵循以下指南。

要做出贡献,需要满足以下标准

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

许可

Klarna Checkout REST PHP SDK 在 Apache License, Version 2.0 许可下授权:Apache License, Version 2.0