1. 支付接口.... 2
1.1. 支付請(qǐng)求參數(shù)... 2
1.2. 支付返回參數(shù)... 3
2. 退款接口.... 4
1.3. 退款請(qǐng)求參數(shù)... 4
1.4. 退款返回參數(shù)... 4
3. 查詢接口.... 5
1.5. 查詢請(qǐng)求參數(shù)... 5
1.6. 查詢返回參數(shù)... 5

基本參數(shù)說明,如下:
參數(shù) | 名稱 | 說明 |
MerchantID | 商戶編號(hào) | 必填,由支付平臺(tái)提供,如:100000 |
TransactionID | 客戶端流水號(hào) | 必填,40位長(zhǎng)度,商戶提交的客戶端流水號(hào)必須唯一 |
OrderID | 商戶訂單號(hào) | 必填,50位長(zhǎng)度 |
Amount | 交易金額 | 必填,實(shí)際交易金額,正數(shù)(小數(shù)只能保留2位),如:1234.56 |
CurrencyCode | 幣種代碼 | 必填,CNY人民幣/USD美元 |
ReturnUrl | 支付完成跳轉(zhuǎn)地址 | 選填,200位長(zhǎng)度 瀏覽器重定向到的頁(yè)面 |
NotifyUrl | 后臺(tái)通知的地址 | 選填,200位長(zhǎng)度 支付成功,后臺(tái)主動(dòng)通知的地址 |
Description | 商品描述 | 選填,500位長(zhǎng)度 |
PaymentCatalog | 支付類別 | 選填,500位長(zhǎng)度,以“,”分隔,為空則顯示所有支付類別,按照設(shè)置的順序顯示,如“1,2,3” |
PaymentWay | 支付方式 | 選填,500位長(zhǎng)度,以“,”分隔,為空則顯示所有支付方式,按照設(shè)置的順序顯示,如“ICBC,CCB,PayPal” |
MerchantData | 商戶私有信息 | 選填,500位長(zhǎng)度,原樣返回 |
Language | 語(yǔ)言 | 必填,ZH簡(jiǎn)體中文,HK繁體中文,EN英文 |
UserID | 用戶標(biāo)識(shí) | 必填,100位長(zhǎng)度,用戶在商戶站點(diǎn)注冊(cè)的賬戶標(biāo)識(shí) |
UserName | 用戶名稱 | 必填,100位長(zhǎng)度,用戶在商戶站點(diǎn)注冊(cè)的賬戶名稱 |
Sign | 簽名 | 必填,32位長(zhǎng)度 |
生成簽名的步驟:
1) 使用&連接各參數(shù)名稱/值對(duì),最終格式示例如下:
MerchantID=000001&TransactionID=1234567890&OrderID=1234567890
&Amount=1234.56&CurrencyCode=CNY
&ReturnUrl=http://xxx/MerchantDemo/PayReturn.aspx
&NotifyUrl=http://xxx/MerchantDemo/PayNotify.aspx
&Description=絢麗奪目的Retina顯示屏&PaymentCatalog=1,2,3&PaymentWay=
&MerchantData=test&Language=ZH&UserID=testuser&UserName=測(cè)試用戶
2) 調(diào)用在線支付平臺(tái)公共方法(.NET)SecurityUtil.CreateSign生成簽名
商戶站點(diǎn)以POST方式將支付請(qǐng)求發(fā)送到在線支付平臺(tái),F(xiàn)ORM表單示例如下:
<formname="sendOrder" method="POST" action="http://xxx/Gateway/Pay.aspx">
<inputtype="hidden" name="MerchantID"value="000001"/>
<inputtype="hidden" name="TransactionID"value="1234567890"/>
<inputtype="hidden" name="OrderID" value="1234567890"/>
<inputtype="hidden" name="Amount" value="1234.56"/>
<inputtype="hidden" name="CurrencyCode"value="CNY"/>
<inputtype="hidden" name="ReturnUrl" value="http://xxx/MerchantDemo/PayReturn.aspx"/>
<inputtype="hidden" name="NotifyUrl" value="http://xxx/MerchantDemo/PayNotify.aspx"/>
<inputtype="hidden" name="Description" value="絢麗奪目的Retina顯示屏"/>
<inputtype="hidden" name="PaymentCatalog"value="1,2,3"/>
<inputtype="hidden" name="PaymentWay" value=""/>
<inputtype="hidden" name="MerchantData"value="test"/>
<inputtype="hidden" name="Language" value="ZH"/>
<inputtype="hidden" name="UserID" value="testuser"/>
<inputtype="hidden" name="UserName"value="testuser"/>
<inputtype="hidden" name="Sign" value="FC8A5AA8D05A5DF5C7AB2C245212EB2C"/>
</form>
支付返回參數(shù)說明,如下:
參數(shù) | 名稱 | 說明 |
MerchantID | 商戶編號(hào) | 原樣返回 |
TransactionID | 客戶端流水號(hào) | 原樣返回 |
OrderID | 商戶訂單號(hào) | 原樣返回 |
Amount | 訂單金額 | 原樣返回 |
CurrencyCode | 幣種代碼 | 原樣返回 |
PaymentRequestID | 支付平臺(tái)流水號(hào) |
|
MerchantData | 商戶私有信息 | 原樣返回 |
PaymentCatalog | 支付類別 | 原樣返回 |
PaymentWay | 支付方式 | 原樣返回 |
Status | 支付狀態(tài)信息 | Y(成功)/ N(失敗) |
Result | 結(jié)果描述 | 當(dāng)失敗時(shí),為失敗的描述信息 |
UserID | 用戶標(biāo)識(shí) | 原樣返回 |
UserName | 用戶名稱 | 原樣返回 |
Sign | 簽名 | 必填,32位長(zhǎng)度 |
支付結(jié)果信息會(huì)按照一定的規(guī)律發(fā)送到商戶站點(diǎn)指定的后臺(tái)通知的地址(通過 POST 方式發(fā)送),直到達(dá)到指定次數(shù)或者商戶站點(diǎn)返回成功信息“Y”給在線支付平臺(tái)。
使用&連接各返回參數(shù)名稱/值對(duì),最終格式示例如下:
MerchantID=000001&TransactionID=1234567890&OrderID=1234567890&Amount=1234.56
&CurrencyCode=CNY&PaymentRequestID=000001101128093059000001
&MerchantData=test&PaymentCatalog=1,2,3&PaymentWay=&Status=Y
&Result=支付成功!&UserID=testuser&UserName=測(cè)試用戶
然后使用商戶密鑰進(jìn)行簽名,并生成FORM表單。
在線支付平臺(tái)通過POST方式發(fā)送支付結(jié)果信息到商戶站點(diǎn),F(xiàn)ORM表單示例如下:
<formname="sendOrder" method="POST" action="http://xxx/MerchantDemo/PayNotify.aspx”/>
<inputtype="hidden" name="MerchantID" value="000001”/>
<inputtype="hidden" name="TransactionID" value="1234567890”/>
<inputtype="hidden" name="OrderID" value="1234567890”/>
<inputtype="hidden" name="Amount" value="1234.56”/>
<inputtype="hidden" name="CurrencyCode" value="CNY”/>
<inputtype="hidden" name="PaymentRequestID" value="000001101128093059000001”/>
<inputtype="hidden" name="MerchantData" value="test”/>
<inputtype="hidden" name="PaymentCatalog" value="1,2,3”/>
<inputtype="hidden" name="PaymentWay" value="”/>
<inputtype="hidden" name="Status" value="Y”/>
<inputtype="hidden" name="Result" value="支付成功!”/>
<inputtype="hidden" name="UserID" value="testuser”/>
<inputtype="hidden" name="UserName"value="testuser"/>
<inputtype="hidden" name="Sign" value="8CCC53AD8FC4F376E1055A049AE2C87F”/>
</form>
商戶站點(diǎn)調(diào)用在線支付平臺(tái)提供的方法(.NET)SecurityUtil.VerifySign驗(yàn)證簽名,并檢查訂單號(hào)是否已處理,幣種、金額等是否與原始訂單一致等,然后進(jìn)行后續(xù)處理。
參數(shù) | 名稱 | 說明 |
MerchantID | 商戶編號(hào) |
|
TransactionID | 客戶端流水號(hào) |
|
RefundAmount | 退款金額 |
|
CurrencyCode | 幣種代碼 |
|
RefundReason | 退款說明 |
|
Sign | 簽名 |
|
回復(fù)正文一行一項(xiàng),格式為參數(shù)名稱/值對(duì)(key=value),其中value 是URL 編碼的字符串。需要對(duì)此回復(fù)數(shù)據(jù)進(jìn)行適當(dāng)解析,然后進(jìn)行 URL解碼。
參數(shù) | 名稱 | 說明 |
MerchantID | 商戶編號(hào) |
|
TransactionID | 客戶端流水號(hào) |
|
RefundAmount | 退款金額 |
|
CurrencyCode | 幣種代碼 |
|
Status | 返回結(jié)果 | 0(失敗)/ 1(成功) |
Result | 結(jié)果描述 |
|
Sign | 簽名 |
|
有兩種方式進(jìn)行查詢:按日期段查詢、按訂單號(hào)查詢。
按日期段查詢參數(shù),將對(duì)查詢結(jié)果進(jìn)行分頁(yè), 每頁(yè)50條記錄:
參數(shù) | 名稱 | 說明 |
MerchantID | 商戶編號(hào) |
|
BeginDate | 開始日期 |
|
EndDate | 結(jié)束日期 |
|
PageIndex | 當(dāng)前頁(yè) | 從0開始 |
Sign | 簽名 |
|
按訂單號(hào)查詢參數(shù):
參數(shù) | 名稱 | 說明 |
MerchantID | 商戶編號(hào) |
|
TransactionID | 客戶端流水號(hào) |
|
Sign | 簽名 |
|
回復(fù)正文一行一項(xiàng),格式為參數(shù)名稱/值對(duì)(key=value),其中value 是URL 編碼的字符串。需要對(duì)此回復(fù)數(shù)據(jù)進(jìn)行適當(dāng)解析,然后進(jìn)行 URL解碼。
按日期段查詢返回參數(shù):
參數(shù) | 名稱 | 說明 |
MerchantID | 商戶編號(hào) |
|
ResultData | 結(jié)果數(shù)據(jù) | JSON格式 |
Sign | 簽名 |
|
按訂單號(hào)查詢返回參數(shù):
參數(shù) | 名稱 | 說明 |
MerchantID | 商戶編號(hào) |
|
TransactionID | 客戶端流水號(hào) |
|
OrderID | 商戶訂單號(hào) |
|
Amount | 訂單金額 |
|
CurrencyCode | 幣種代碼 |
|
PaymentRequestID | 支付平臺(tái)流水號(hào) |
|
Description | 商品描述 |
|
PaymentCatalog | 支付類別 |
|
PaymentWay | 支付方式 |
|
MerchantData | 商戶私有信息 |
|
Status | 狀態(tài) | 0(未支付)/ 1(已支付) |
RefundAmount | 已退款金額 |
|
UserID | 用戶標(biāo)識(shí) |
|
UserName | 用戶名稱 |
|
Sign | 簽名 |
|
新聞熱點(diǎn)
疑難解答
圖片精選
網(wǎng)友關(guān)注