5. PHP接入支付宝单笔订单查询接口

左手的ㄟ右手 2022-09-25 00:24 345阅读 0赞

[payment 项目2.0版本][payment _2.0]

巴西奥运会来了，刚好我又是做体育行业的互联网。哎！这个月又要加班成狗了。最近遇到好多莫名其妙的问题，待我忙完这段，再跟大家分享下。今天还是继续说说 [Payment项目][Payment]  
今天主要说说支付宝订单查询接口。

# 接口调用 #

废话废话不多说。直接上支付宝订单查询的代码。微信的订单查询与此类似。后续也会更新文档。

// 支付宝配置信息
    $aliconfig = [
        'partner'   => '2088xxxxx',
        'md5_key'   => 'xxxxxxxxxxxx',
        'rsa_private_key'   => dirname(__FILE__) . '/rsa_private_key.pem',
        "notify_url"    => 'http://test.helei.com/pay-notify.html',
        "return_url"    => 'http://test.helei.com/return-url.html',
        "time_expire"   => '14',
    ];
    
    
    $data = [
        // 通过支付宝交易号查询， 推荐 效率更高
        'transaction_id'    => '2016011421001004330041239366',// 支付宝
    
        // 通过订单号查询
        'order_no'    => '2016011402433464',// 支付宝
    ];
    
    $query = new QueryContext();
    
    try {
        // 支付宝查询
        $query->initQuery(Config::ALI, $aliconfig);
        $ret = $query->query($data);
    
    } catch (PayException $e) {
        echo $e->errorMessage();exit;
    }
    
    var_dump($ret);

非常简单，只需要提供支付宝的流水号，或者商家自己生成的订单号，就可完成订单详情的查询，当然前提是，依然要去签约这个接口（觉得支付宝真扯淡，都能够支付了，为什么查询还要单独签约？这一点微信比它强）

如果同时提供了 `transaction_id` 跟 `order_no` 这两个参数，会优先使用 `transaction_id` ,因为他的效率要高的多。

代码完成了下面分别解释下请求的参数。以及返回参数。关于支付宝的配置参数，请参考 [PHP接入支付宝手机网站支付、移动支付接口][PHP]

# 请求参数 #

查询订单的参数非常简单。这里能够查询的仅指：支付成功后的订单

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>是否必须</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>transaction_id</td> 
   <td>支付宝流水号</td> 
   <td>支付成功后，异步通知中会返回</td> 
   <td>二选一</td> 
  </tr> 
  <tr> 
   <td>order_no</td> 
   <td>商户订单号</td> 
   <td>商户生成的唯一订单号</td> 
   <td>二选一</td> 
  </tr> 
 </tbody> 
</table>

对于上表中的数据，两个字段二选一即可。推荐使用 `transaction_id` ，该字段查询效率更高。如果两个字段同时提供，会优先使用 `transaction_id`。

请求后，程序会向支付宝进行查询。查询完成后，会将返回的数据做一定处理然后返回给客户端。

# 返回参数 #

查询存在两种情况，失败，成功，分别对返回字段含义进行说明。

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>是否必须</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>is_success</td> 
   <td>成功标识</td> 
   <td>请求是否成功，T:成功，F:失败</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>error</td> 
   <td>错误提示</td> 
   <td>只有is_success=F时才返回</td> 
   <td>否</td> 
  </tr> 
  <tr> 
   <td>response</td> 
   <td>响应数据</td> 
   <td>查询成功后返回的数据，一个数组，is_success=T时返回</td> 
   <td>否</td> 
  </tr> 
 </tbody> 
</table>

关于 `response` 中包含字段的描述

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>参数名</th> 
   <th>参数说明</th> 
   <th>是否必须</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>subject</td> 
   <td>商品名称</td> 
   <td>订单的关键字</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>body</td> 
   <td>商品描述</td> 
   <td>提交订单时的body值</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>amount</td> 
   <td>交易金额</td> 
   <td>本次订单总金额</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>channel</td> 
   <td>支付渠道</td> 
   <td>本处取值： ali</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>order_no</td> 
   <td>商户网站唯一订单号</td> 
   <td>商户生成的订单号，必须确保在系统中唯一</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>buyer_id</td> 
   <td>买家支付宝账户号</td> 
   <td>可以是Email或手机号码。</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>trade_state</td> 
   <td>交易状态</td> 
   <td>支付成功与否，可取值：success not_pay</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>transaction_id</td> 
   <td>支付宝交易号</td> 
   <td>支付宝系统中的交易流水号，可用于查询订单状态</td> 
   <td>是</td> 
  </tr> 
  <tr> 
   <td>time_end</td> 
   <td>交易付款时间</td> 
   <td>格式为2016-07-28 16:01:01</td> 
   <td>是</td> 
  </tr> 
 </tbody> 
</table>

针对查询返回的数据，调用者可进行相关的业务处理。如果需要更多信息可联系我进行定制开发，也可自行更改代码完成。

[payment _2.0]: https://github.com/helei112g/payment/tree/paymentv2
[Payment]: https://github.com/helei112g/payment
[PHP]: https://helei112g.github.io/2016/07/29/PHP%E6%8E%A5%E5%85%A5%E6%94%AF%E4%BB%98%E5%AE%9D%E6%89%8B%E6%9C%BA%E7%BD%91%E7%AB%99%E6%94%AF%E4%BB%98%E3%80%81%E7%A7%BB%E5%8A%A8%E6%94%AF%E4%BB%98%E6%8E%A5%E5%8F%A3/