支付寶即時到賬介面開發
支付寶即時到帳介面
環境要求
支付寶網頁即時到賬功能,可讓使用者線上向開發者的支付寶賬號支付資金,交易資金即時到賬,幫助開發者快速回籠資金。
交易步驟少,簡單、方便。
交易資金三個月內可退款,提升買家購物保障。
有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 "驗證失敗";
}
通知客戶,你的訂單支付成功/失敗。 結束整個支付流程。