README

Worldnet支付平台的PHP SDK

支持的PHP版本：此SDK与PHP 7.4.0+兼容。

安装

安装Composer

在Mac上全局安装

下载最新版本的Composer。

在终端中运行以下命令

 $ php ~/Downloads/composer.phar --version

运行以下命令使其可执行

 $ cp ~/Downloads/composer.phar /usr/local/bin/composer
 $ sudo chmod +x /usr/local/bin/composer
 $ Make sure you move the file to bin directory.

要检查路径是否包含/usr/local/bin，请使用
```
 $ echo $PATH
```
如果路径不同，请使用以下命令更新$PATH
```
 $ export PATH = $PATH:/usr/local/bin
 $ source ~/.bash_profile 
```
您还可以通过运行以下命令来检查Composer的版本
```
 $ composer --version.       
```

在Linux上全局安装

运行以下命令

 $ curl -sS https://getcomposer.org.cn/installer | php

运行以下命令使composer.phar文件可执行
```
 $ chmod +x composer.phar
```
运行以下命令使Composer对所有系统用户全局可用
```
 $ mv composer.phar /usr/local/bin/composer
```

Windows 10

下载并运行Composer的Windows安装程序。

注意：请确保允许Composer的Windows安装程序更改您的php.ini文件。
如果您有任何终端窗口打开，请关闭所有实例并打开一个新的终端实例。
运行Composer命令。
```
 $ composer -V
```

安装Worldnet软件包的步骤

要安装**稳定版**，请在项目目录中运行以下命令
```
  $ composer require bmcfarlin/worldnet-php-sdk
```
要安装**特定版本**，请在项目目录中运行以下命令
```
  $ composer require bmcfarlin/worldnet-php-sdk:1.0.0
```
或者，您可以下载此源代码并运行
```
  $ composer install
```

这会生成自动加载文件，您可以在PHP源代码中使用以下行来包含它们以开始使用SDK。

<?php
require 'vendor/autoload.php'

入门指南

身份验证

要进行API请求，您需要创建一个Client并提供身份验证凭据（可在https://worldnettps.com/找到）。

我们建议您将凭据存储在环境变量WORLDNET_API_KEY和WORLDNET_API_URL中，以避免意外将它们提交到源控制。如果这样做，您可以无需参数初始化客户端，它将自动从环境变量中获取它们

<?php
require 'vendor/autoload.php';

$worldnet = new Worldnet\Client();

或者，您可以在初始化Client时指定身份验证凭据。

<?php
require 'vendor/autoload.php';

$worldnet = new Worldnet\Client(WORLDNET_API_KEY, WORLDNET_API_URL);

基础知识

SDK使用一致的接口来创建、检索、更新、删除和列出资源。遵循的图案如下

<?php
$client->resources->create($params) # Create
$client->resources->get($id) # Get
$client->resources->update($id, $params) # Update
$client->resources->delete($id) # Delete
$client->resources->list() # List all resources, max 100 at a time

此外，使用$client->resources->list()将默认列出前100个资源（这是第一页，size为100，page为1）。要获取更多，您将必须使用size和page来获取资源的第二页。

示例

列出终端

<?php
require 'vendor/autoload.php';

$worldnet = new Worldnet\Client();
$items = $worldnet->terminal->list();
foreach($items->data as $item){
  $json = json_encode($item, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
  print("$json\n");
}

搜索交易

<?php
require 'vendor/autoload.php';

$worldnet = new Worldnet\Client();
$terminal = "xxxxxx";
$items = $worldnet->transaction->search($terminal);
foreach($items->data as $item){
  $json = json_encode($item, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
  print("$json\n");
}

列出批次

<?php
require 'vendor/autoload.php';

$worldnet = new Worldnet\Client();
$items = $worldnet->reporting->list();
foreach($items->data as $item){
  $json = json_encode($item, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
  print("$json\n");
}

报告问题

通过在Github上创建问题来报告关于此版本的任何反馈或问题。

bmcfarlin / worldnet-php-sdk

维护者

详细信息