interkassa/php-sdk

Interkassa SDK

1.1.4 2022-06-20 15:58 UTC

This package is auto-updated.

Last update: 2024-09-15 06:50:49 UTC


README

支付服务提供商

支付服务提供商(PSP)为在线商店提供接受各种支付方式(包括信用卡、基于银行的支付,如直接借记、银行转账和基于在线银行的实际银行转账)的电子支付服务。通常,它们使用软件即服务模型,并为他们的客户(商家)形成一个单一的支付网关,以支持多种支付方式。了解更多信息

安装

此 SDK 使用 composer。

Composer 是 PHP 中的依赖管理工具。它允许您声明项目依赖的库,并且它会为您管理(安装/更新)它们。

有关如何使用/安装 composer 的更多信息,请访问 https://github.com/composer/composer

Composer 安装

composer require interkassa/php-sdk

手动安装

git clone https://github.com/interkassa/php-sdk.git
<?php
require '/path-to-sdk/autoload.php';

从您的网站直接发送 POST 请求,无需 PHP 编码。

<form
  name="payment"
  method="post"
  action="https://sci.interkassa.com/"
  accept-charset="UTF-8"
>
  <input type="hidden" name="ik_co_id" value="51237daa8f2a2d8413000000" />
  <input type="hidden" name="ik_pm_no" value="ID_1234" />
  <input type="hidden" name="ik_am" value="1.44" />
  <input type="hidden" name="ik_cur" value="uah" />
  <input type="hidden" name="ik_desc" value="Payment Description" />
  <input type="submit" value="Pay" />
</form>

开始配置

require 'vendor/autoload.php';

$configuration = new \Interkassa\Helper\Config();
$configuration->setCheckoutSecretKey('5rkFvckBLKcDHQrW');
$configuration->setAuthorizationKey('TpIJabcdefgdtNabcdefgMCeYvdVkF');
$configuration->setAccountId('ffa001aaaa00000000001234');

$SDKClient = new \Interkassa\Interkassa($configuration);

获取重定向到 SCI(创建发票)的链接 了解更多

$invoiceRequest = new \Interkassa\Request\GetInvoiceRequest();
$invoiceRequest
    ->setCheckoutId('5fa005a06a00000000001234')
    ->setPaymentNumber('ID_1234')
    ->setAmount('100')
    ->setCurrency('UAH')
    ->setDescription('Payment Description');

$url = $SDKClient->makeInvoiceSciLink($invoiceRequest);
$SDKClient->redirect($url);

获取带有参数的重定向到支付系统的表单(创建发票) 了解更多

$invoiceRequest = new \Interkassa\Request\PostInvoiceRequest();
$invoiceRequest
    ->setCheckoutId('5fa005a06a00000000001234')
    ->setPaymentNumber('ID_1234')
    ->setAmount('100')
    ->setCurrency('UAH')
    ->setDescription('Payment Description')
    ->setAction('process')
    ->setPaywayVia('test_interkassa_test_xts');

$result = $SDKClient->makeInvoicePaySystemLink($invoiceRequest);

$code = $result->getCode();
$status = $result->getStatus();
$message = $result->getMessage();
$data = $result->getData();

$html = $SDKClient->redirectForm($data);
echo $html;

计算发票 了解更多

$invoiceRequest = new \Interkassa\Request\CalculateRequest();
$invoiceRequest
    ->setCheckoutId('5fa005a06a00000000001234')
    ->setPaymentNumber('ID_1234')
    ->setAmount('100')
    ->setCurrency('UAH')
    ->setDescription('Payment Description')
    ->setAction('payway')
    ->setPaywayVia('test_interkassa_test_xts');

$result = $SDKClient->calculateInvoice($invoiceRequest);

$code = $result->getCode();
$status = $result->getStatus();
$message = $result->getMessage();
$data = $result->getData();

获取可用于结账的支付方向列表。 了解更多

$invoiceRequest = new \Interkassa\Request\PaymentDirectionsRequest();
$invoiceRequest
    ->setCheckoutId('5fa005a06a00000000001234')
    ->setPaymentNumber('ID_1234')
    ->setAmount('100')
    ->setCurrency('UAH')
    ->setDescription('Payment Description')
    ->setAction('payways');
    ->setPaymentMethod('visa')
    ->setPaymentCurrency('USD');

$result = $SDKClient->getPaymentDirection($invoiceRequest);

$code = $result->getCode();
$status = $result->getStatus();
$message = $result->getMessage();
$data = $result->getData();

返回所有货币 了解更多

$result = $SDKClient->getCurrencyList();

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

通过 ID 返回具体货币 了解更多

$result = $SDKClient->getCurrencyById('30');

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回包含在 Interkassa 系统中的输入支付方向的列表。 了解更多

$result = $SDKClient->getPaysystemInputPaywayList();

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回包含在 Interkassa 系统中的指定 ID 的输入支付方向。 了解更多

$result = $SDKClient->getPaysystemInputPaywayById('11a001111100000000001234');

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回包含在 Interkassa 系统中的提款支付方向的列表。 了解更多

$result = $SDKClient->getPaysystemOutputPaywayList();

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回包含在 Interkassa 系统中的提款支付方向。 了解更多

$result = $SDKClient->getPaysystemOutputPaywayById('11a001111100000000004321');

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回用户可用的账户列表 了解更多

$result = $SDKClient->getAccountList();

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回给定 ID 的账户数据 了解更多

$result = $SDKClient->getAccountById('ffa001aaaa00000000001234');

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回与您的账户链接的结账列表。 了解更多

$result = $SDKClient->getCheckoutList();

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回给定 ID 的结账数据。 了解更多

$result = $SDKClient->getCheckoutById('11a002222200000000004321');

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回所有支付。 了解更多

$result = $SDKClient->getAllInvoices();

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

根据ID返回支付数据。阅读更多

$result = $SDKClient->getInvoiceById('134001234');

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回已完成的提款列表。阅读更多

$result = $SDKClient->getWithdrawList();

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回特定提款ID的信息。阅读更多

$result = $SDKClient->getWithdrawById('15001234');

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回与账户关联的钱包列表及其参数。阅读更多

$result = $SDKClient->getPurseList();

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

$result = $SDKClient->getPurseList([
   'checkoutId' => '11a002222200000000004321',
   'currency' => '20'
]);

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

返回指定ID的钱包数据。阅读更多

$result = $SDKClient->getPurseById('404300001234');

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

在Interkassa系统中创建退款。阅读更多

$refundRequest = new \Interkassa\Request\RefundRequest();
$refundRequest
    ->setId('134001234')
    ->setAmount('15')
    ->setDescription('Reason of the refund');
$result = $SDKClient->makeRefund($refundRequest);

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

在Interkassa系统中创建新的提款。阅读更多

$withdrawRequest = new \Interkassa\Request\WithdrawRequest();
$withdrawRequest
    ->setAmount('15')
    ->setMethod('card')
    ->setCurrency('uah')
    ->setAction('process')
    ->setDetail('card', '5100123412341234')
    ->setPurseId('300000912345')
    ->setUseShortAlias('true');
$result = $SDKClient->makeWithdraw($withdrawRequest);

$code = $result->getCode();
$status = $result->getStatus();
$data = $result->getData();

API

查看API文档