README

PHP Wadify SDK 使开发者能够轻松地在PHP代码中访问Wadify。

资源

• README文件 - 用于入门和深入了解SDK使用信息
• 问题 - 报告问题，提交拉取请求，并参与其中
• @wadifytech - 关注我们的Twitter

特性

• 提供易于使用的HTTP客户端，用于所有支持的Wadify服务和认证协议。
• 基于Guzzle构建，并利用了许多其特性，包括持久连接、异步请求、中间件等。

入门指南

1. 注册Wadify - 在开始之前，您需要注册一个Wadify账户并获取您的Wadify凭证
2. 最低要求 - 运行SDK之前，您的系统需要满足最低要求，包括PHP >= 5.6，编译了cURL扩展，并且cURL 7.16.2+编译了TLS后端（例如，NSS或OpenSSL）。
3. 安装SDK – 使用Composer是推荐安装PHP Wadify SDK的方式。SDK可以通过Packagist在wadify/wadify-sdk-php包下获得。
4. 使用SDK – 以下部分将帮助您了解如何使用SDK。入门指南将帮助您熟悉基本概念。

用户指南

安装

通过composer cli

composer require wadify/wadify-sdk-php

通过composer json

{
...
	"require": {
		...,
		"wadify/wadify-sdk-php": "^1.0",
	}
}

然后

composer update

创建Wadify客户端

仅使用必需选项的示例

<?php
// Require the Composer autoloader.
require __DIR__.'/vendor/autoload.php';

use Wadify\Client;

// Instantiate the client.
$client = new Client([
    'apiKey' => '{your-api-key}',
    'clientId' => '{your-client-id}',
    'clientSecret' => '{your-client-secret}'
]);

使用不同令牌提供者的示例

<?php
// Require the Composer autoloader.
require __DIR__.'/vendor/autoload.php';

use Wadify\Client;

// Instantiate the client.
$client = new Client([
    'apiKey' => '{your-api-key}',
    'clientId' => '{your-client-id}',
    'clientSecret' => '{your-client-secret}'
    'token' => [
        'provider' => '{your-provider-class-namespace}',
        'args' => [...]
    ]
]);

必需选项

• apiKey: API密钥
• clientId: 客户端标识符
• clientSecret: 客户端密钥

非必需选项

• version: 锁定所需的API版本。例如，v1或最新版
• sandbox: true或false。如果您想使用生产或沙盒模式。默认为生产模式
• token: 令牌配置数组。
  • provider: 提供者类字符串。默认我们使用FileSystemProvider
  • args: 提供者需要的参数。默认我们发送一个标准路径。/tmp/wadify/token.json

使用Wadify客户端

获取用户

<?php
$user = $client->getUser(); // array

获取交易

<?php
$transactions = $client->getTransactions(); // array

获取交易

<?php
$transaction = $client->getTransaction('your-trasaction-id'); // array

中止交易

<?php
$id = ;
$transaction = $client->abortTransaction('your-trasaction-id'); // array

创建交易

<?php
$data = [
    "amount" => 100,
    "subject" => "Transaction number one",
    "response_url" => "http://your.response.url/",
    "source_account" => "e76ad9ea-dbc1-11e5-a764-109add42947b",
    "destination_account" => [
        "name" => "Javier Rodriguez",
        "iban" => "ES1800491500042710151321"
    ],
    "fingerprint" => [
        "order" => "secret,amount,subject,response_url,source_account,destination_account.name,destination_account.iban",
        "hash" => "{hash}"
    ]
]
$transaction = $client->createTransaction($data); // array

自定义令牌存储提供者

您可以创建自己的令牌存储提供者。默认我们使用FileSystemProvider。

自定义令牌存储提供者的示例

构造函数中的参数实际上来自客户端配置中的args值。

<?php

namespace Your\Namespace;

use Wadify\Token\StorageProvider\StorageProviderInterface;
use Wadify\Token\Token;

class CustomProvider implements StorageProviderInterface
{   
    public function get() 
    {
    ...
    }
    
    public function set(Token $token)
    {
    ...
    }
}

有关发送数据的更多信息，请查看API文档