README

此仓库已存档，请使用官方 Sumup PHP SDK。

要求

PHP 5.6 及以上版本。

Composer

您可以通过 Composer 安装绑定。运行以下命令

composer require alexcode/sumup-php

基本用法

设置您的凭证

Sumup\Sumup::setClientSecret('MY_CLIENT_SECRET');
Sumup\Sumup::setClientId('MY_CLIENT_ID');
Sumup\Sumup::setRedirectUri('MY_OAUTH_REDIRECT');

OAuth

作为商家，您需要通过 OAuth 授权您的应用代表您进行请求

授权码授权

获取重定向商家到授权 URL。

SumUp 文档授权码授权

Sumup\OAuth::authorizeUrl(['scope' => 'payments']);
// https://api.sumup.com/authorize?scope=payments&client_id=MY_CLIENT_ID&redirect_uri=MY_OAUTH_REDIRECT&response_type=code

在确认对话框后，商家浏览器将带有代码的 GET 参数重定向到您的重定向 URI（例如：http://MY_OAUTH_REDIRECT/?code=246d97b0b730c61f5929drfb3a444948fd54c058d0416019）

因此，您可以为您的商家创建一个访问令牌来代表其操作。

获取访问令牌

$access_token = Sumup\OAuth::getToken([
  'grant_type' => 'authorization_code',
  'code' => '246d97b0b730c61f5929drfb3a444948fd54c058d0416019'
]);

刷新访问令牌

SumUp 文档刷新令牌

$refreshed = Sumup\OAuth::refreshToken($access_token);

结账

在服务器端创建结账

SumUp 文档创建结账 API

$checkout = Sumup\Checkout::create([
  'amount' => 20,
  'currency' => 'EUR',
  'checkout_reference' => 'MY_REF',
  'pay_to_email' => 'MY_CUSTOMER_EMAIL',
]);

echo $checkout->getCompleteUrl();
// https://api.sumup.com/v0.1/checkouts/123456

在客户端完成结账

使用 URL 在客户端浏览器中完成支付。因此，没有任何 PCI 数据会到达您的服务器。

SumUp 文档完成结账 API

PUT https://api.sumup.com/v0.1/checkouts/123456

body:
{
  "payment_type": "card",
  "card": {
    "name": "...",
    "number": "...",
    "expiry_year": "...",
    "expiry_month": "...",
    "cvv": "..."
  }
}

请注意，只有您的 OAuth 设置中作为授权 JavaScript 原点存在的域名才能在浏览器中完成结账。

当前实现 SumUp API 的列表

结账 API

创建结账
完成结账
创建客户
获取支付工具
创建支付工具
禁用支付工具

交易 API

交易历史记录
交易详情
退款交易
收据数据

账户 API

获取账户
获取个人资料
创建个人资料
获取商户资料
创建商户资料
获取DBA
编辑DBA
获取银行账户
创建银行账户
获取支付设置
编辑支付设置

账户API员工

创建员工
获取员工
更改员工凭证

账户API货架

获取货架
创建货架
创建货架
编辑货架
删除货架

账户API产品

获取产品
创建产品
获取产品
编辑产品
删除产品
获取产品价格
创建产品价格
获取产品价格
编辑产品价格
删除产品价格

账户API应用设置

获取应用设置
编辑应用设置

积分

本库受到了Stripe PHP的启发

alexcode / sumup-php

维护者

详细信息