支付宝即时到账接口开发 - DEMO讲解

支付宝即时到帐接口

环境要求

PHP5.0以上，且需要开启curl、openssl。
文档地址：
https://doc.open.alipay.com/doc2/detail?treeId=62&articleId=103566&docType=1

支付宝网页即时到账功能，可让用户在线向开发者的支付宝账号支付资金，交易资金即时到账，帮助开发者快速回笼资金。
交易步骤少，简单、方便。
交易资金三个月内可退款，提升买家购物保障。

有2个demo:
即时到账交易接口(create_direct_pay_by_user)（DEMO下载）
即时到账批量退款有密接口(refund_fastpay_by_platform_pwd)（DEMO下载）

我们主要学习即时到账交易接口(create_direct_pay_by_user)。

电商网站支付流程图

选择demo

即时到账交易接口(create_direct_pay_by_user) demo下载解压之后目录如下图：

选择:MD5签名版本/create_direct_pay_by_user-PHP-UTF-8

我们把这些文件放到，web目录pay下，然后访问：http://localhost/pay/

点击『确认支付』，^_^

1.编辑alipay.config.php

//↓↓↓↓↓↓↓↓↓↓请在这里配置您的基本信息↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
//合作身份者ID，签约账号，以2088开头由16位纯数字组成的字符串，查看地址：https://b.alipay.com/order/pidAndKey.htm
$alipay_config['partner']      = '';

//收款支付宝账号，以2088开头由16位纯数字组成的字符串，一般情况下收款账号就是签约账号
$alipay_config['seller_id']	= $alipay_config['partner'];

// MD5密钥，安全检验码，由数字和字母组成的32位字符串，查看地址：https://b.alipay.com/order/pidAndKey.htm
$alipay_config['key']          = '';

// 服务器异步通知页面路径 需http://格式的完整路径，不能加?id=123这类自定义参数，必须外网可以正常访问
$alipay_config['notify_url'] = "http://商户网址/create_direct_pay_by_user-PHP-UTF-8/notify_url.php";

// 页面跳转同步通知页面路径 需http://格式的完整路径，不能加?id=123这类自定义参数，必须外网可以正常访问
$alipay_config['return_url'] = "http://商户网址/create_direct_pay_by_user-PHP-UTF-8/return_url.php";

//签名方式
$alipay_config['sign_type']    = strtoupper('MD5');

//字符编码格式 目前支持 gbk 或 utf-8
$alipay_config['input_charset']= strtolower('utf-8');

//ca证书路径地址，用于curl中ssl校验
//请保证cacert.pem文件在当前文件夹目录中
$alipay_config['cacert']    = getcwd().'\\cacert.pem';

//访问模式,根据自己的服务器是否支持ssl访问，若支持请选择https；若不支持请选择http
$alipay_config['transport']    = 'http';

// 支付类型 ，无需修改
$alipay_config['payment_type'] = "1";

// 产品类型，无需修改
$alipay_config['service'] = "create_direct_pay_by_user";

//↑↑↑↑↑↑↑↑↑↑请在这里配置您的基本信息↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑


//↓↓↓↓↓↓↓↓↓↓ 请在这里配置防钓鱼信息，如果没开通防钓鱼功能，为空即可 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓

// 防钓鱼时间戳 若要使用请调用类文件submit中的query_timestamp函数
$alipay_config['anti_phishing_key'] = "";

// 客户端的IP地址 非局域网的外网IP地址，如：221.0.0.1
$alipay_config['exter_invoke_ip'] = "";

//↑↑↑↑↑↑↑↑↑↑请在这里配置防钓鱼信息，如果没开通防钓鱼功能，为空即可 ↑↑↑↑↑↑↑↑↑↑↑↑↑↑↑

在上面的配置中，我们就单单填写好$alipay_config['partner'] 和$alipay_config['key']这2项后(注意必须是签约商家的配置信息)
这样我们『确认支付』会跳转到http://www.mydev.com/alipayapi.php，然后跳转到支付宝的支付页面。

当你支付完成以后，会发送同步通知，跳回

// 页面跳转同步通知页面路径 需http://格式的完整路径，不能加?id=123这类自定义参数，必须外网可以正常访问
$alipay_config['return_url'] = "http://商户网址/create_direct_pay_by_user-PHP-UTF-8/return_url.php";

不定时的异步通知(如果同步通知成功，就不发异步通知了)

// 服务器异步通知页面路径 需http://格式的完整路径，不能加?id=123这类自定义参数，必须外网可以正常访问
$alipay_config['notify_url'] = "http://商户网址/create_direct_pay_by_user-PHP-UTF-8/notify_url.php";

2.demo流程总结
第一步：在index.php中，构建订单信息表单，有以下几个字段

WIDout_trade_no 商户订单号
WIDsubject      商品名称
WIDtotal_fee    付款金额
WIDbody         商品描述

第二步：表单提交到alipayapi.php， 在alipayapi.php接收参数

/**************************请求参数**************************/
//商户订单号，商户网站订单系统中唯一订单号，必填
        $out_trade_no = $_POST['WIDout_trade_no'];

//订单名称，必填
        $subject = $_POST['WIDsubject'];

//付款金额，必填
        $total_fee = $_POST['WIDtotal_fee'];

//商品描述，可空
        $body = $_POST['WIDbody'];

然后构建请求支付宝的参数：

//构造要请求的参数数组，无需改动
$parameter = array(
"service"       => $alipay_config['service'],
"partner"       => $alipay_config['partner'],
"seller_id"  => $alipay_config['seller_id'],
"payment_type"  => $alipay_config['payment_type'],
"notify_url"    => $alipay_config['notify_url'],
"return_url"    => $alipay_config['return_url'],

"anti_phishing_key"=>$alipay_config['anti_phishing_key'],
"exter_invoke_ip"=>$alipay_config['exter_invoke_ip'],
"out_trade_no"  => $out_trade_no,
"subject"   => $subject,
"total_fee" => $total_fee,
"body"  => $body,
"_input_charset"    => trim(strtolower($alipay_config['input_charset']))
//其他业务参数根据在线开发文档，添加参数.文档地址:https://doc.open.alipay.com/doc2/detail.htm?spm=a219a.7629140.0.0.kiX33I&treeId=62&articleId=103740&docType=1
//如"参数名"=>"参数值"

);

然后发送请求(给支付宝)，就跳转到支付宝的支付页面

//建立请求
$alipaySubmit = new AlipaySubmit($alipay_config);
$html_text = $alipaySubmit->buildRequestForm($parameter,"get", "确认");
echo $html_text;

第三步：支付完成同步通知(return_url.php)给网站，不定时异步通知（notify_url.php）给网站。

return_url.php或者notify_url.php，都是处理验证结果

//计算得出通知验证结果
$alipayNotify = new AlipayNotify($alipay_config);
$verify_result = $alipayNotify->verifyReturn();
if($verify_result) {//验证成功
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
//请在这里加上商户的业务逻辑程序代码

//——请根据您的业务逻辑来编写程序（以下代码仅作参考）——
//获取支付宝的通知返回参数，可参考技术文档中页面跳转同步通知参数列表

//商户订单号

    $out_trade_no = $_GET['out_trade_no'];

//支付宝交易号

    $trade_no = $_GET['trade_no'];

//交易状态
    $trade_status = $_GET['trade_status'];


if($_GET['trade_status'] == 'TRADE_FINISHED' || $_GET['trade_status'] == 'TRADE_SUCCESS') {
//判断该笔订单是否在商户网站中已经做过处理
//如果没有做过处理，根据订单号（out_trade_no）在商户网站的订单系统中查到该笔订单的详细，并执行商户的业务程序
//如果有做过处理，不执行商户的业务程序
    }
else {
      echo "trade_status=".$_GET['trade_status'];
    }

    echo "验证成功<br />";

//——请根据您的业务逻辑来编写程序（以上代码仅作参考）——

/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////
}
else {
//验证失败
//如要调试，请看alipay_notify.php页面的verifyReturn函数
    echo "验证失败";
}

通知客户，你的订单支付成功/失败。 结束整个支付流程。