## 請求地址:
### http://域名/Pay.html
## 請求類型:
POST
## 請求參數:
| 變量名稱 | 參數名稱 | 是否必填 | 是否參與簽名 | 參數說明 |
| --- | --- | ---|--- | --- |
| version | 版本號 | 是 | 是 | 固定值:1.0.0 |
| memberid | 商戶號 | 是 | 是 | 系統分配的商戶編號,例如:10001 |
| orderid | 商戶訂單號 | 是 | 是 | 商戶訂單號,長度32個字符以內,只許包含大小寫英文字母、數字和下劃線(_) |
| amount | 訂單金額 | 是 | 是 | 交易訂單金額,單位:分 |
| orderdatetime | 訂單提交時間 | 是 | 是 | 格式:YYYY-mm-dd HH:ii:ss 例如:2020-02-02 20:20:20 |
| paytype | 通道編碼 | 是 | 是 | 詳細請見 :[通道/銀行編碼表](通道編碼.md) |
| notifyurl | 異步回調地址 | 是 | 是 | 支付成功后系統異步回調商戶的地址 |
| callbackurl | 同步跳轉地址 | 否 | 否 | 支付成功后系統同步跳轉商戶的地址 |
| extend | 擴展字段 | 否 | 否 | 異步回調/同步跳轉時會原值返回 |
| signmethod | 簽名類型 | 是 | 是 | 固定值: md5 |
| sign | md5簽名 | 是 | 否 | 請看[簽名算法](簽名算法.md) |
*****
**交易請求Demo(php代碼示例,其它編程語言僅供參考)**
*****
```php
<?php
$ArrayField = [
'version' => '1.0.0',
'memberid' => '10001',
'orderid' => "1000120200202202020",
'amount' => '100',
'orderdatetime' => "",
'notifyurl' => 'http://xxx.xxx.com/notifyurl.php',
'paytype' => 'WXGZH',
'signmethod' => 'md5',
];
ksort($ArrayField); //按照參數名ASCII碼從小到大排序
$md5key = '2JXQBG13TAUNKRYVME'; //md5密鑰
$stringA = "";
foreach($ArrayField as $key => $value){
$stringA .= $key."=".$value."&";
}
$stringA = substr($stringA,0,-1); //去掉最后一個 & 字符
$ArrayField["sign"] = strtoupper(md5($stringA.$md5key)); //拼接密鑰后,md5加密后轉為大寫
$tjurl = 'http://main.lanmaopay.cn/Pay.html';
$str = '<form id="Form1" name="Form1" method="post" action="' . $tjurl . '">';
foreach ($ArrayField as $key => $val) {
$str = $str . $key . ':' . $val . '<br /><input type="hidden" name="' . $key . '" value="' . $val . '">';
}
$str = $str . '<input type="submit" value="submit">';
$str = $str . '</form>';
$str = $str . '<script>';
$str = $str . 'document.Form1.submit();';
$str = $str . '</script>';
echo($str);
?>
```
## 回調參數
異步回調和同步跳轉都是POST,參數都是一樣的。
如果接收到系統異步回調時,在頁面輸出“OK”(沒有雙引號,OK 兩個字母大寫),否則會不定時重復發起回調請求。
| 變量名稱 | 參數名稱 | 是否參與簽名 | 參數說明 |
| --- | --- | --- | --- |
| version | 版本號 | 是 | 固定值:1.0.0 |
| memberid| 商戶號 | 是 | 系統分配的商戶編號,例如:10001 |
| amount| 訂單金額 | 是 | 訂單提交的金額,單位:分 |
| true_amount | 實際支付金額 | 是 | 實際支付金額,單位:分。注:有時系統可能會對提交的整數金額隨機加上一個幾分錢的零頭,所以可能會出現訂單金額與實際支付金額不一樣的情況,絕大部分情況下這兩個金額是一致的 |
| amount_trade| 交易手續費 | 是 | 當前訂單扣除的手續費,單位:分 |
| orderid| 商戶訂單號 | 是 | 商戶提交給系統的訂單號 |
| sysorderid| 系統訂單號 | 是 | 系統生成的內部訂單號 |
| submitime| 提交時間 | 是 | 訂單提交建立的時間。格式:YYYY-mm-dd HH:ii:ss 例如:2020-02-02 20:20:20 |
| successtime| 交易成功時間 | 是 | 訂單交易成功的時間。格式:YYYY-mm-dd HH:ii:ss 例如:2020-02-02 20:20:20 |
| tongdao | 交易通道編碼 | 是 | 詳細請見 :[通道/銀行編碼表](通道-銀行編碼.md) |
| status| 訂單關狀態 | 是 | success 成功,error 失敗 |
| signmethod| 簽名類型 | 是 | 固定值:md5 |
| extend | 擴展字段 | 如果存在此參數就參與簽名 | 原值返回提交時的extend 字段的值 |
| sign | md5簽名 | 否 | 請看[簽名算法](簽名算法.md) |
*****
**回調Demo(php代碼示例,其它編程語言僅供參考)**
*****
> 建議在收到回調,驗簽通過且狀態為成功時,再調取[查詢接口](查詢文檔.md)查詢一下訂單的狀態是否真的為成功后,再來處理自己的業務邏輯
```php
<?php
$ArrayField = $_POST;
$sign = $ArrayField["sign"];
unset($ArrayField["sign"]);
$md5key = '2JXQBG13TAUNKRYVME'; //密鑰
ksort($ArrayField); //按照參數名ASCII碼從小到大排序
$stringA = "";
foreach($ArrayField as $key => $value){
$stringA .= $key."=".$value."&";
}
$stringA = substr($stringA,0,-1); //去掉最后一個 & 字符
$signValue = strtoupper(md5($stringA.$md5key)); //拼接密鑰后,md5加密后轉為大寫
if($signValue == $sign and $ArrayField["status"] == "success"){
//建議在收到回調,驗簽通過且狀態為成功時,再調查詢接口查詢一下訂單的狀態是否正的為成功后,再來處理自己的業務邏輯
// 交易成功后的業務邏輯處理
exit('OK');
}
?>
```