README

solidpay-php-client是Solidpay的官方客户端。Solidpay API允许您以安全可靠的方式接受支付。

安装

Composer

如果您使用Composer管理项目的依赖项，只需将solidpay/solidpay-php-client添加到您的项目的composer.json文件中。以下是一个仅定义Solidpay最新稳定版本的依赖项的composer.json文件的示例：

{
    "require": {
        "solidpay/php-client": "1.0.*"
    }
}

通过命令行

通过命令行添加Solidpay存储库同样简单。只需键入

composer require solidpay/php-client

手动上传

如果您无法使用Composer或没有对服务器的SSH访问权限，可以将/solidpay/上传到您的Web空间。然而，这样您就需要自己管理类的自动加载。

使用方法

在执行任何操作之前，您应该在Solidpay上注册自己并获取访问凭证。

创建新的支付

require_once("/vendor/autoload.php");

use Solidpay\Solidpay;

try {

$api_key = 'YOUR_KEY';
$merchant_id = 'YOUR_MERCHANT_ID';

$client = new Solidpay($api_key, $merchant_id);

$form = array(
    'order_id' => 'YOUR_TRANSACTION_ID',
    'currency' => 'gbp',
    'amount' => '100',
    'capture' => false,
    'return_url' => 'https://yourstore.com/success/123456'
);

$payments = $client->request->post('/payments/', $form);

$status = $payments->httpStatus();

if ($status == 200){
    $payments = $payments->asArray();
    $paymentUrl = $payments['url'];
    $paymentId = $payments['id'];
}

} catch (Exception $e) {
    
}

响应

如果有效载荷成功，您将获得如下所示的响应。

{
    "status": "success",
    "id": "502244",
    "url": "https://solidpay.io/payments/bd1b9bc8c35df675a9b174d499aa7e2e4dfd1658fe8bbd4c4a94a247deb969f3"
}

API调用

之后，您可以使用对应的http方法和端点调用Solidpay API中描述的任何方法。目前支持的方法有：get、post、put、patch和delete。您可以在Postman集合中找到API调用的完整列表。

// Get all payments
$payments = $client->request->get('/payments');

// Get specific payment
$payments = $client->request->get('/payments/{id}');

// Refund payment
$form = array(
    'amount' => '100',
);

$payments = $client->request->post('/payments/{id}/refund', $form);

// Capture payment
$form = array(
    'amount' => '100',
);

$payments = $client->request->post('/payments/{id}/capture', $form);