mirror of
https://gitee.com/yansongda/pay.git
synced 2024-12-04 21:29:29 +08:00
Updates doc/alipay/verify.md
Auto commit by GitBook Editor
This commit is contained in:
yansongda
parent
34a1a08ac5
commit
01184d8ef1
@ -164,7 +164,7 @@ class PayController extends Controller
|
||||
|
||||
public function return()
|
||||
{
|
||||
$data = Pay::alipay($this->config)->verify();
|
||||
$data = Pay::alipay($this->config)->verify(); // 是的，验签就这么简单！
|
||||
|
||||
// 订单号：$data->out_trade_no
|
||||
// 支付宝交易号：$data->trade_no
|
||||
@ -176,7 +176,7 @@ class PayController extends Controller
|
||||
$alipay = Pay::alipay($this->config);
|
||||
|
||||
try{
|
||||
$data = $alipay->verify();
|
||||
$data = $alipay->verify(); // 是的，验签就这么简单！
|
||||
|
||||
// 请自行对 trade_status 进行判断及其它逻辑进行判断，在支付宝的业务通知中，只有交易通知状态为 TRADE_SUCCESS 或 TRADE_FINISHED 时，支付宝才会认定为买家付款成功。
|
||||
// 1、商户需要验证该通知数据中的out_trade_no是否为商户系统中创建的订单号；
|
||||
@ -245,7 +245,7 @@ class PayController extends Controller
|
||||
$pay = Pay::wechat($this->config);
|
||||
|
||||
try{
|
||||
$data = $pay->verify();
|
||||
$data = $pay->verify(); // 是的，验签就这么简单！
|
||||
|
||||
Log::debug('Wechat notify', $data);
|
||||
} catch (Exception $e) {
|
||||
|
||||
@ -8,6 +8,7 @@
|
||||
* [取消](doc/alipay/cancel.md)
|
||||
* [关闭](doc/alipay/close.md)
|
||||
* [验证服务器数据](doc/alipay/verify.md)
|
||||
* [异步通知成功后返回给支付宝服务器](doc/alipay/echoSuccess.md)
|
||||
* [微信](doc/wechat/README.md)
|
||||
* [支付](doc/wechat/pay.md)
|
||||
* [退款](doc/wechat/refund.md)
|
||||
|
||||
@ -54,12 +54,13 @@ $alipay = Pay::alipay($config)->close('out_trade_no_123456'); // 返回 `Yansong
|
||||
|
||||
// 验证服务器数据
|
||||
$alipay = Pay::alipay($config)
|
||||
|
||||
// 是的，验签就这么简单！
|
||||
$data = $alipay->verify(); // 返回 `Yansongda\Supports\Collection` 实例，可以通过 `$data->xxx` 访问服务器返回的数据。
|
||||
|
||||
$alipay->success()->send(); // 向支付宝服务器确认接收到的数据。laravel 框架中请直接 `return $alipay->success()`
|
||||
```
|
||||
|
||||
|
||||
|
||||
# 注意
|
||||
|
||||
后续文档中，如果没有特别说明， `$alipay` 均代表`Pay::alipay($config)`
|
||||
|
||||
@ -0,0 +1,36 @@
|
||||
# 说明
|
||||
|
||||
| 方法名 | 参数 | 返回值 |
|
||||
| :---: | :---: | :---: |
|
||||
| cancel | string\|array $order | Collection |
|
||||
|
||||
# 使用方法
|
||||
|
||||
## 例子
|
||||
|
||||
```php
|
||||
$order = [
|
||||
'out_trade_no' => '1514027114',
|
||||
];
|
||||
|
||||
// $order = '1514027114';
|
||||
|
||||
$result = $alipay->cancel($order);
|
||||
```
|
||||
|
||||
## 订单配置参数
|
||||
|
||||
所有订单配置参数和官方无任何差别，兼容所有功能，所有参数请参考[这里](https://docs.open.alipay.com/api_1/alipay.trade.cancel/)，查看「请求参数一栏」。
|
||||
|
||||
# 返回值
|
||||
|
||||
返回 Collection 类型，可以通过 `$collection->xxx` 得到服务器返回的数据。
|
||||
|
||||
# 异常
|
||||
|
||||
* Yansongda\Pay\Exceptions\InvalidSignException ，表示验签失败。
|
||||
* Yansongda\Pay\Exceptions\GatewayException ，表示支付宝服务器返回的数据非正常结果，例如，参数错误等。
|
||||
* Yansongda\Pay\Exceptions\InvalidConfigException ，表示缺少配置参数，如，`ali_public_key`, `private_key` 等
|
||||
|
||||
|
||||
|
||||
@ -0,0 +1,36 @@
|
||||
# 说明
|
||||
|
||||
| 方法名 | 参数 | 返回值 |
|
||||
| :---: | :---: | :---: |
|
||||
| close | string\|array $order | Collection |
|
||||
|
||||
# 使用方法
|
||||
|
||||
## 例子
|
||||
|
||||
```php
|
||||
$order = [
|
||||
'out_trade_no' => '1514027114',
|
||||
];
|
||||
|
||||
// $order = '1514027114';
|
||||
|
||||
$result = $alipay->close($order);
|
||||
```
|
||||
|
||||
## 订单配置参数
|
||||
|
||||
所有订单配置参数和官方无任何差别，兼容所有功能，所有参数请参考[这里](https://docs.open.alipay.com/api_1/alipay.trade.close/)，查看「请求参数一栏」。
|
||||
|
||||
# 返回值
|
||||
|
||||
返回 Collection 类型，可以通过 `$collection->xxx` 得到服务器返回的数据。
|
||||
|
||||
# 异常
|
||||
|
||||
* Yansongda\Pay\Exceptions\InvalidSignException ，表示验签失败。
|
||||
* Yansongda\Pay\Exceptions\GatewayException ，表示支付宝服务器返回的数据非正常结果，例如，参数错误等。
|
||||
* Yansongda\Pay\Exceptions\InvalidConfigException ，表示缺少配置参数，如，`ali_public_key`, `private_key` 等
|
||||
|
||||
|
||||
|
||||
31
doc/alipay/echoSuccess.md
Normal file
31
doc/alipay/echoSuccess.md
Normal file
@ -0,0 +1,31 @@
|
||||
# 说明
|
||||
|
||||
| 方法名 | 参数 | 返回值 |
|
||||
| :---: | :---: | :---: |
|
||||
| success | 无 | Response |
|
||||
|
||||
# 使用方法
|
||||
|
||||
```php
|
||||
|
||||
// $result = $alipay->verify();
|
||||
|
||||
return $alipay->success()->send(); // laravel 框架直接 return $alipay->success();
|
||||
```
|
||||
|
||||
## 订单配置参数
|
||||
|
||||
无
|
||||
|
||||
# 返回值
|
||||
|
||||
返回 Response 类型，可以通过` return $response->send();` 进行返回；如果在 laravel 框架中，可直接 `return $response;`
|
||||
|
||||
# 异常
|
||||
|
||||
* Yansongda\Pay\Exceptions\InvalidSignException ，表示验签失败。
|
||||
* Yansongda\Pay\Exceptions\GatewayException ，表示支付宝服务器返回的数据非正常结果，例如，参数错误等。
|
||||
* Yansongda\Pay\Exceptions\InvalidConfigException ，表示缺少配置参数，如，`ali_public_key`, `private_key` 等
|
||||
|
||||
|
||||
|
||||
@ -0,0 +1,36 @@
|
||||
# 说明
|
||||
|
||||
| 方法名 | 参数 | 返回值 |
|
||||
| :---: | :---: | :---: |
|
||||
| find | string\|array $order | Collection |
|
||||
|
||||
# 使用方法
|
||||
|
||||
## 例子
|
||||
|
||||
```php
|
||||
$order = [
|
||||
'out_trade_no' => '1514027114',
|
||||
];
|
||||
|
||||
// $order = '1514027114';
|
||||
|
||||
$result = $alipay->find($order);
|
||||
```
|
||||
|
||||
## 订单配置参数
|
||||
|
||||
所有订单配置参数和官方无任何差别，兼容所有功能，所有参数请参考[这里](https://docs.open.alipay.com/api_1/alipay.trade.query/)，查看「请求参数一栏」。
|
||||
|
||||
# 返回值
|
||||
|
||||
返回 Collection 类型，可以通过 `$collection->xxx` 得到服务器返回的数据。
|
||||
|
||||
# 异常
|
||||
|
||||
* Yansongda\Pay\Exceptions\InvalidSignException ，表示验签失败。
|
||||
* Yansongda\Pay\Exceptions\GatewayException ，表示支付宝服务器返回的数据非正常结果，例如，参数错误等。
|
||||
* Yansongda\Pay\Exceptions\InvalidConfigException ，表示缺少配置参数，如，`ali_public_key`, `private_key` 等
|
||||
|
||||
|
||||
|
||||
@ -2,22 +2,20 @@
|
||||
|
||||
支付宝支付目前支持 6 中支付方法，对应的支付 method 如下：
|
||||
|
||||
| method | 说明 | 返回值 |
|
||||
| :--- | :--- | :---: |
|
||||
| web | 电脑支付 | Response |
|
||||
| wap | 手机网站支付 | Response |
|
||||
| app | APP 支付 | JsonResponse |
|
||||
| pos | 刷卡支付 | Collection |
|
||||
| scan | 扫码支付 | Collection |
|
||||
| transfer | 账户转账 | Collection |
|
||||
|
||||
|
||||
| method | 说明 | 参数 | 返回值 |
|
||||
| :--- | :--- | :---: | :--- |
|
||||
| web | 电脑支付 | array $order | Response |
|
||||
| wap | 手机网站支付 | array $order | Response |
|
||||
| app | APP 支付 | array $order | JsonResponse |
|
||||
| pos | 刷卡支付 | array $order | Collection |
|
||||
| scan | 扫码支付 | array $order | Collection |
|
||||
| transfer | 账户转账 | array $order | Collection |
|
||||
|
||||
# 使用方法
|
||||
|
||||
## 一、电脑支付
|
||||
|
||||
### 0、 例子
|
||||
### 例子
|
||||
|
||||
```php
|
||||
$order = [
|
||||
@ -29,15 +27,15 @@ $order = [
|
||||
return $alipay->web($order)->send(); // laravel 框架中请直接 return $alipay->web($order)
|
||||
```
|
||||
|
||||
### 1、 订单配置参数
|
||||
### 订单配置参数
|
||||
|
||||
**所有订单配置中，客观参数均不用配置，扩展包已经为大家自动处理了，比如，`product_code` 等参数。**
|
||||
**所有订单配置中，客观参数均不用配置，扩展包已经为大家自动处理了，比如，**`product_code`** 等参数。**
|
||||
|
||||
所有订单配置参数和官方无任何差别，兼容所有功能，所有参数请参考[这里](https://docs.open.alipay.com/270/alipay.trade.page.pay)，查看「请求参数一栏」。
|
||||
|
||||
## 二、手机网站支付
|
||||
|
||||
### 0、例子
|
||||
### 例子
|
||||
|
||||
```php
|
||||
$order = [
|
||||
@ -49,15 +47,15 @@ $order = [
|
||||
return $alipay->wap($order)->send(); // laravel 框架中请直接 return $alipay->wap($order)
|
||||
```
|
||||
|
||||
### 1、订单配置参数
|
||||
### 订单配置参数
|
||||
|
||||
**所有订单配置中，客观参数均不用配置，扩展包已经为大家自动处理了，比如，`product_code` 等参数。**
|
||||
**所有订单配置中，客观参数均不用配置，扩展包已经为大家自动处理了，比如，**`product_code`** 等参数。**
|
||||
|
||||
所有订单配置参数和官方无任何差别，兼容所有功能，所有参数请参考[这里](https://docs.open.alipay.com/203/107090/)，查看「请求参数一栏」。
|
||||
|
||||
## 三、APP 支付
|
||||
|
||||
### 0、 例子
|
||||
### 例子
|
||||
|
||||
```php
|
||||
$order = [
|
||||
@ -70,15 +68,15 @@ $order = [
|
||||
return $alipay->app($order)->send(); // laravel 框架中请直接 return $alipay->app($order)
|
||||
```
|
||||
|
||||
### 1、 订单配置参数
|
||||
### 订单配置参数
|
||||
|
||||
**所有订单配置中，客观参数均不用配置，扩展包已经为大家自动处理了，比如，`product_code` 等参数。**
|
||||
**所有订单配置中，客观参数均不用配置，扩展包已经为大家自动处理了，比如，**`product_code`** 等参数。**
|
||||
|
||||
所有订单配置参数和官方无任何差别，兼容所有功能，所有参数请参考[这里](https://docs.open.alipay.com/204/105465/)，查看「请求参数一栏」。
|
||||
|
||||
## 四、刷卡支付
|
||||
|
||||
### 0、例子
|
||||
### 例子
|
||||
|
||||
```php
|
||||
$order = [
|
||||
@ -91,15 +89,15 @@ $order = [
|
||||
$result = $alipay->pos($order);
|
||||
```
|
||||
|
||||
### 1、订单配置参数
|
||||
### 订单配置参数
|
||||
|
||||
**所有订单配置中，客观参数均不用配置，扩展包已经为大家自动处理了，比如，`product_code` 等参数。**
|
||||
**所有订单配置中，客观参数均不用配置，扩展包已经为大家自动处理了，比如，**`product_code`** 等参数。**
|
||||
|
||||
所有订单配置参数和官方无任何差别，兼容所有功能，所有参数请参考[这里](https://docs.open.alipay.com/api_1/alipay.trade.pay)，查看「请求参数一栏」。
|
||||
|
||||
## 五、扫码支付
|
||||
|
||||
### 0、例子
|
||||
### 例子
|
||||
|
||||
```php
|
||||
$order = [
|
||||
@ -112,15 +110,15 @@ $result = $alipay->scan($order);
|
||||
//二维码内容： $qr = $result->qr_code;
|
||||
```
|
||||
|
||||
### 1、订单配置参数
|
||||
### 订单配置参数
|
||||
|
||||
**所有订单配置中，客观参数均不用配置，扩展包已经为大家自动处理了，比如，`product_code` 等参数。**
|
||||
**所有订单配置中，客观参数均不用配置，扩展包已经为大家自动处理了，比如，**`product_code`** 等参数。**
|
||||
|
||||
所有订单配置参数和官方无任何差别，兼容所有功能，所有参数请参考[这里](https://docs.open.alipay.com/api_1/alipay.trade.precreate)，查看「请求参数一栏」。
|
||||
|
||||
## 六、转账
|
||||
|
||||
### 0、例子
|
||||
### 例子
|
||||
|
||||
```php
|
||||
$order = [
|
||||
@ -133,9 +131,9 @@ $order = [
|
||||
$result = $alipay->transfer($order);
|
||||
```
|
||||
|
||||
### 1、订单配置参数
|
||||
### 订单配置参数
|
||||
|
||||
**所有订单配置中，客观参数均不用配置，扩展包已经为大家自动处理了，比如，`product_code` 等参数。**
|
||||
**所有订单配置中，客观参数均不用配置，扩展包已经为大家自动处理了，比如，**`product_code`** 等参数。**
|
||||
|
||||
所有订单配置参数和官方无任何差别，兼容所有功能，所有参数请参考[这里](https://docs.open.alipay.com/api_28/alipay.fund.trans.toaccount.transfer)，查看「请求参数一栏」。
|
||||
|
||||
@ -143,7 +141,7 @@ $result = $alipay->transfer($order);
|
||||
|
||||
**各支付方法返回值请参考「支持的支付方法」一节。**
|
||||
|
||||
返回只会返回两种类型 `Symfony\Component\HttpFoundation\Response` 或 `Yansongda\Supports\Collection`
|
||||
返回只会返回两种类型 `Symfony\Component\HttpFoundation\Response` 或 `Yansongda\Supports\Collection`
|
||||
|
||||
* 返回 Response 类型时，可以通过 `return $response->send()` 直接进行返回（laravel 框架中使用请直接`return $response` ）
|
||||
* 返回 Collection 类型时，可以通过 `$collection->xxx` 得到服务器返回的数据。
|
||||
|
||||
@ -0,0 +1,35 @@
|
||||
# 说明
|
||||
|
||||
| 方法名 | 参数 | 返回值 |
|
||||
| :---: | :---: | :---: |
|
||||
| refund | array $order | Collection |
|
||||
|
||||
# 使用方法
|
||||
|
||||
## 例子
|
||||
|
||||
```php
|
||||
$order = [
|
||||
'out_trade_no' => '1514027114',
|
||||
'refund_amount' => '0.01',
|
||||
];
|
||||
|
||||
$result = $alipay->refund($order);
|
||||
```
|
||||
|
||||
## 订单配置参数
|
||||
|
||||
所有订单配置参数和官方无任何差别，兼容所有功能，所有参数请参考[这里](https://docs.open.alipay.com/api_1/alipay.trade.refund)，查看「请求参数一栏」。
|
||||
|
||||
# 返回值
|
||||
|
||||
返回 Collection 类型，可以通过 `$collection->xxx` 得到服务器返回的数据。
|
||||
|
||||
# 异常
|
||||
|
||||
* Yansongda\Pay\Exceptions\InvalidSignException ，表示验签失败。
|
||||
* Yansongda\Pay\Exceptions\GatewayException ，表示支付宝服务器返回的数据非正常结果，例如，参数错误等。
|
||||
* Yansongda\Pay\Exceptions\InvalidConfigException ，表示缺少配置参数，如，`ali_public_key`, `private_key` 等
|
||||
|
||||
|
||||
|
||||
@ -0,0 +1,30 @@
|
||||
# 说明
|
||||
|
||||
| 方法名 | 参数 | 返回值 |
|
||||
| :---: | :---: | :---: |
|
||||
| verify | 无 | Collection |
|
||||
|
||||
# 使用方法
|
||||
|
||||
```php
|
||||
$result = $alipay->verify();
|
||||
|
||||
// return $alipay->success()->send(); // laravel 框架直接 return $alipay->success();
|
||||
```
|
||||
|
||||
## 订单配置参数
|
||||
|
||||
无
|
||||
|
||||
# 返回值
|
||||
|
||||
返回 Collection 类型，可以通过 `$collection->xxx` 得到服务器返回的数据。
|
||||
|
||||
# 异常
|
||||
|
||||
* Yansongda\Pay\Exceptions\InvalidSignException ，表示验签失败。
|
||||
* Yansongda\Pay\Exceptions\GatewayException ，表示支付宝服务器返回的数据非正常结果，例如，参数错误等。
|
||||
* Yansongda\Pay\Exceptions\InvalidConfigException ，表示缺少配置参数，如，`ali_public_key`, `private_key` 等
|
||||
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user