PHP接入支付宝 即时到帐接口

likeconan 2019-06-20

payment 项目2.0版本

特别声明:

以下文档均针对 payment 2.0 以上版本,并且PHP需要5.5以上(含)。
代码中所有编码均使用 utf-8 。

通过几天的时间,终于把payment 2.0的基本结构搭好了。今天刚完成支付宝 即时到帐 接口的开发。赶紧把使用文档给补上。请大家一定仔细查看文档,实在还不行就来问我吧!(我期待你问我,反正我收钱的,哈哈)

即时到帐 接口签约

在你使用这个接口时,请先确认你是否在支付宝商户中心签约了该接口。

PHP接入支付宝 即时到帐接口

在商户中心,看到 即时到帐(已添加),说明你已签约该接口,可正常使用。如果还不知道如何签约,请 查看支付宝即时到帐签约教程

OK!完成签约后,

需要把 payment项目导入自己的项目中 安装方法,请参考Payment项目简介

调用示例

在项目的 examples 文件夹中,我已提供完整的示例。为了便于大家理解,这里对代码再进行说明。

支付宝的配置文件

在1.x版本中,配置文件被固定写在了sdk中,这种做法太流氓了。为了不继续流氓下去,在2.x版本中,将配置信息独立出来,让大家可以根据自己的实际情况自定义,灵活程度大大增加。

调用时,仅需要提供给我如下的一个数组,至于配置信息写在哪里,完全由你自己决定。

我在示例中,是将配置信息写在 examples/aliconfig.php 中,然后使用 require_once 包含进来。你完全可以写cache中、db中。

return [
    'partner'   => '2088xxxxxxxxxxx',
    'md5_key'   => 'xxxxxxxxxxxxxxxxxx',
    'rsa_private_key'   => './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',
];

参数介绍

参数参数名参数说明是否必须
partner合作者身份ID签约的支付宝账号对应的支付宝唯一用户号。以2088开头的16位纯数字组成。必须
md5_keyMD5密钥点击这里必须
rsa_private_keyRSA私钥点击这里必须
notify_url服务器异步通知URI支付宝服务器主动通知商户网站里指定的页面http路径。(建议使用https)可选
return_url页面跳转同步通知页面路径支付宝处理完请求后,当前页面自动跳转到商户网站里指定页面的http路径。可选
time_expire超时时间设置未付款交易的超时时间,一旦超时,该笔交易就会自动被关闭。单位默认为分钟可选

特别说明:

  • 如果上述配置文件必须的key的值为空,会抛出 PayException 异常

  • 如果 notify_url 为空,虽然可支付成功,但是客户端将无法收到支付宝的回调结果。

  • 建议采用https协议

调用支付

项目中的示例代码,参见 examples/charge.php

//  生成订单号 便于测试
function createPayid()
{
    return date('Ymdhis', time())
            .substr(floor(microtime()*1000),0,1)
            .rand(0,9);
}

// 订单信息
$orderData = [
    "orderTradeNo"    => createPayid(),
    "totalFee"    => '1',
    "clientIp"    => '127.0.0.1',
    "subject"    => '我是即时到帐',
    "body"    => '支付测试即时到帐接口',
    "extraCommonParam"    => '',
];

$aliconfig = require_once __DIR__ . '/aliconfig.php';


// 实例化支付环境类,进行支付创建
$charge = new ChargeContext();

try {
    $charge->initCharge(Config::ALI_CHANNEL_WEB, $aliconfig);
    $url = $charge->charge($payData);
} catch (PayException $e) {
    echo $e->errorMessage();exit;
}

// 请求alipay
header("Location:{$url}");

以上代码就完成了即时到帐的全部调用,下面分步骤来说明下代码含义:

订单信息

此部分的key部分,必须采用以下值,否则SDK无法识别。

// createPayid(); 函数是为了演示方便,随手写的一个生成订单号的函数

$orderData = [
    "order_no"    => createPayid(),
    "amount"    => '1',// 单位为元
    "client_ip"    => '127.0.0.1',
    "subject"    => '测试支付',
    "body"    => '支付接口测试',
    "extra_param"    => '',
];

参数说明

参数参数名参数说明是否必须
order_no订单号平台根据规则生成的订单号,最长64位,要在商户数据库中唯一必须
amount交易总金额该笔订单的资金总额,单位为RMB-Yuan。取值范围为[0.01,100000000.00],精确到小数点后两位。必须
client_ip客户端IP用户在创建交易时,该用户当前所使用机器的IP。必须
subject商品名称商品的标题/交易标题/订单标题/订单关键字等。该参数最长为128个汉字。必须
body商品描述对一笔交易的具体描述信息。如果是多种商品,请将商品描述字符串累加传给body。必须
extra_param公用回传参数如果用户请求时传递了该参数,则返回给商户时会回传该参数。可选

签名数据

以下是真正实现数据签名的地方,返回的数据可直接用于发起支付宝支付。大家可以对比下支付宝自身信息,是不是已经大大简化了?
当然简化带来的另外一个意思就是:放弃了很多我们正常情况下用不到的功能,比如:花呗分期

// 实例化支付环境类,进行支付创建
$charge = new ChargeContext();

try {
    $charge->initCharge(Config::ALI_CHANNEL_WEB, $aliconfig);
    $url = $charge->charge($payData);
} catch (PayException $e) {
    echo $e->errorMessage();exit;
}

这里对于调用者,仅仅需要知道 ChargeContext 这一个类,这里使用了 策略模式 + 简单工厂模式 两种方法来进行调用的简化。这种方式也非常方便后期进行扩展,对于客户端与复杂的逻辑进行了隔离。

跳转支付宝

通过上一步返回的是请求支付宝的url。由于在页面上可能需要通过js调用支付宝或者还有其他逻辑,因为我并没有直接重定向到支付宝,而把控制权交到了客户端手中。

以下代码,示例的是简单的利用返回的url,重定向到支付宝,完成支付。

header("Location:{$url}");

本次支付宝的即时到帐接口到这里就完成了调用。下一节把回调通知部分完成,这样一个基本的支付流程就完成了。

技术支持

如果需要协助集成到项目,可付费获得我的服务!

PHP接入支付宝 即时到帐接口

相关推荐