# PHP SDK

### 获取SDK

GitHub下载：<https://github.com/Asiabill/asiabill_php_sdk>

Composer安装：composer require asiabill/asiabill\_php\_sdk

### 要求

### 要求

PHP 5.6 或更高版本

### PHP依赖

PHP SDK 需要以下扩展才能正常工作：

* [curl](https://www.php.net/manual/en/book.curl.php)
* [json](https://www.php.net/manual/en/book.json.php)
* [openssl](https://www.php.net/manual/en/book.openssl.php)

### 使用PHP SDK

1、 加载AsiabillIntegration.php文件（如果使用Composer安装，跳过此步骤）

```php
include_once "/classes/AsiabillIntegration.php";
```

2、初始化对象

```php
use \Asiabill\Classes\AsiabillIntegration;
$model = 'test'; // test or live
$asiabill = new AsiabillIntegration($model,$gateway_no,$sign_key);
```

3、开启日志，可以通过$dir设置目录，如果不开启则跳过这一步

```php
$asiabill->startLogger($bool，$dir);
```

4、发起请求

```php
$asiabill->request($type,$data) or $asiabill->payment()->request($type,$data);
$asiabill->openapi()->request($type,$data);
```

### 参数说明

**type**：请求类型：字符串

**data**：请求参数：包含path，body，query三个部分

### payment类型

<table><thead><tr><th>类型</th><th width="315.3333333333333">说明</th></tr></thead><tbody><tr><td>customers</td><td>操作客户（包含创建、修改、删除） <a href="/spaces/Mb9UzyxGUyxHylm4UJSJ/pages/vJ4vRCx4fZq6NgiBWyH7">查看</a></td></tr><tr><td>sessionToken</td><td>生成sessionToken <a href="/spaces/Mb9UzyxGUyxHylm4UJSJ/pages/4K3qUXrb3z36yq2C7EkX">查看</a></td></tr><tr><td>paymentMethods</td><td>创建支付方式 <a href="/spaces/Mb9UzyxGUyxHylm4UJSJ/pages/YPeWejYM7FqUVM3XDSUT">查看</a></td></tr><tr><td>paymentMethods_list</td><td>根据客户获取所有支付方式 <a href="/spaces/Mb9UzyxGUyxHylm4UJSJ/pages/YPeWejYM7FqUVM3XDSUT">查看</a></td></tr><tr><td>paymentMethods_update</td><td>更新paymentMethod信息 <a href="/spaces/Mb9UzyxGUyxHylm4UJSJ/pages/YPeWejYM7FqUVM3XDSUT">查看</a></td></tr><tr><td>paymentMethods_query</td><td>获取支付方式 <a href="/spaces/Mb9UzyxGUyxHylm4UJSJ/pages/YPeWejYM7FqUVM3XDSUT">查看</a></td></tr><tr><td>paymentMethods_detach</td><td>解绑支付方式 <a href="/spaces/Mb9UzyxGUyxHylm4UJSJ/pages/YPeWejYM7FqUVM3XDSUT">查看</a></td></tr><tr><td>paymentMethods_attach</td><td>客户附加支付方式 <a href="/spaces/Mb9UzyxGUyxHylm4UJSJ/pages/YPeWejYM7FqUVM3XDSUT">查看</a></td></tr><tr><td>confirmCharge</td><td>确认扣款 <a href="/spaces/Mb9UzyxGUyxHylm4UJSJ/pages/1dVRtiCwvP8pwK5i3TCy">查看</a></td></tr><tr><td>checkoutPayment</td><td>获取支付页面地址 <a href="/spaces/Mb9UzyxGUyxHylm4UJSJ/pages/ssApkmEsxKfSAJ3XnLCG">查看</a></td></tr></tbody></table>

### openApi类型

| 类型            | 说明                                                                                                                  |
| ------------- | ------------------------------------------------------------------------------------------------------------------- |
| Authorize     | 预授权 [查看](https://asiabill.gitbook.io/api-explorer/api-reference/shou-quan-jiao-yi-wan-cheng-che-xiao/authorization) |
| chargebacks   | 拒付查询 [查看](https://asiabill.gitbook.io/api-explorer/api-reference/ju-fu)                                             |
| refund        | 退款申请 [查看](https://asiabill.gitbook.io/api-explorer/api-reference/tui-kuan)                                          |
| refund\_query | 退款查询 [查看](https://asiabill.gitbook.io/api-explorer/api-reference/tui-kuan)                                          |
| logistics     | 上传物流信息 [查看](https://asiabill.gitbook.io/api-explorer/api-reference/wu-liu)                                          |
| transactions  | 交易流水列表 [查看](https://asiabill.gitbook.io/api-explorer/api-reference/jiao-yi-cha-xun)                                 |
| orderInfo     | 交易详情 [查看](https://asiabill.gitbook.io/api-explorer/api-reference/jiao-yi-cha-xun)                                   |

### 添加自定义类型

**$request\_type** 请求类型，自定义字符，与request第一个参数一致，已经存在的类型不能添加\
\&#xNAN;**$request\_path** 接口路径，参考asiabill接口文档

```php
$asiabill->addRequest($request_type,$request_path);
$asiabill->request($request_type,$data) or $asiabill->openapi()->request($request_type,$data)
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://asiabill.gitbook.io/docs/ji-cheng-sdk/php-sdk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
