支付宝即时到帐接口
环境要求
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/
点击『确认支付』,^_^
-
编辑
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 商品描述1234
第二步:表单提交到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;1234
第三步:支付完成同步通知(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 "验证失败"; }
通知客户,你的订单支付成功/失败。 结束整个支付流程。