yuriizee/sensebank-installment-sdk

Sensebank 分期 PHP SDK 库

v1.2.0 2024-03-05 18:35 UTC

This package is auto-updated.

Last update: 2024-09-16 13:03:14 UTC


README

Tests Total Downloads Latest Stable Version License

此库提供了一个干净、灵活且健壮的方式来与 SenseBank 分期 SDK 集成。它将各种 SDK 功能封装成易于使用的 PHP 类和方法,最小化与 SDK 交互所需的工作量,并提高项目可维护性。

安装

composer require yuriizee/sensebank-installment-sdk

功能

以下是该库提供的部分功能

  • 订单创建/取消(Order 类
  • 报表管理(Statement 类
  • 管理担保(Guarantee 类
  • 单例客户端访问(InstallmentSDK 类

要求

  • PHP >= 8.2

API 文档

链接 到详细 API 文档。

用法

<?php

declare(strict_types=1);

use Yuriizee\SenseBankInstallmentSDK\Client;
use Yuriizee\SenseBankInstallmentSDK\Config;
use Yuriizee\SenseBankInstallmentSDK\DataObjects\Order\CreateOrderRequest;
use Yuriizee\SenseBankInstallmentSDK\Enums\OrderLimits;
use Yuriizee\SenseBankInstallmentSDK\Helper\Money;
use Yuriizee\SenseBankInstallmentSDK\InstallmentSDK;

require __DIR__ . '/../vendor/autoload.php';

$config = new Config(
    url: 'https://retailapi.sensebank.com.ua:8243/api/PartnerInstallment/v1.0/',
    partnerId: 'partner',
    password: '!PaRt_Ne09_R#'
);
/**
 * You can create instance with own Psr\Http\Client\ClientInterface implemented class
 */
$client = (new Client($config))->getClient();

$sdk = InstallmentSDK::getInstance($config, $client);

$request = new CreateOrderRequest(
    mPhone: '+380670000000',
    panEnd: '0000',
    orderId: rand(),
    orderSum: Money::toKopecks(
        rand(OrderLimits::MIN_SUM->value, OrderLimits::MAX_SUM->value)
    ),
    orderTerm: rand(2, 5),
    callBackURL: 'https://example.dev',
    eMailPartner: 'test@example.dev'
);

$response = $sdk->order()->createOrder($request);

许可证

Sensebank 分期 SDK PHP 库是开源软件,受 MIT 许可证许可。

Config 类

Config 类用于设置 API 客户端配置

  • url
  • partnerId
  • password

这些参数应直接从 Sens Bank 获取

贡献

欢迎贡献!请随时打开问题报告、功能请求或提交拉取请求。

联系方式

yuriyzee@gmail.com