修訂記錄 | |||
日期 | 描述 | 版本號 | 修改人 |
2017-07-01 | 初始版本 | V1.0.0 | |
2017-08-16 | 格式化文檔,添加異步通知接口,添加相關(guān)接口說(shuō)明 | V1.0.5 | |
2017-08-28 | 1、主掃支付添加超時(shí)時(shí)間; 2、主掃支付subAppid更名為subAppId。 |
jcouyang | |
2017-10-19 | 異步通知添加busi_id和channel_trade_no返回 | V1.0.6 | |
2017-10-25 | B掃C接口添加phone_code字段 | V1.0.7 | jcouyang |
2017-10-31 | 查詢(xún)和異步通知返回添加phone_code字段 | V1.0.8 | jcouyang |
2017-12-12 | 1、查詢(xún),異步通知,刷卡支付返回借貸記標識字段; 2、添加關(guān)閉訂單接口,修改撤銷(xiāo)接口。 |
V1.0.9 | jcouyang |
2017-12-25 | 異步通知添加merchant_param字段 | ||
2017-12-30 | 添加退款查詢(xún)接口 | V1.1.0 | jcouyang |
2018-01-15 | 1、接口添加時(shí)區字段time_zone; 2、添加對海外的支持,涉及到資金的交易添加匯率和轉換后的人民幣金額等相關(guān)字段; 3、被掃支付和查詢(xún)接口添加授權碼的返回。 |
V1.1.1 | jcouyang |
2017-12-25 | 異步通知添加merchant_param字段 | ||
2017-12-25 | 異步通知添加merchant_param字段 |
該接口基于HTTP/HTTPS實(shí)現,請求方式為POST,字符集統一為UTF-8,請求與返回報文格式均為JSON。
Sign的計算方法為:sign=MD5(timestamp+mchtKey+bodyContent):timestamp其中,timestamp為時(shí)間戳(Java開(kāi)發(fā)者可以通過(guò)System.currentTimeMillis()進(jìn)行獲?。?。mchtKey為付付分配到商戶(hù)的密鑰。簽名計算時(shí)候要去掉bodyContent中所有空格和換行符,計算出的sign為32位的小寫(xiě)字母字符串。
假設timestamp=1502675456531,分配到商戶(hù)的KEY為32個(gè)1,請求報文如下:
按照簽名計算方法,則有:sign=MD5(1502675456531111111111111111111111111111111111111111{"busi_id":"581010199011345","operator_id":"test1",
"terminal_id":"收銀機1","total_fee":"250","channel_type":"1","auth_code":"288886863488188613","pay_subject":"測試商品1","out_trade_no":"d2dbe5fb-fc71-4bfe-848f-a24875d9169c","fee_type":"CNY"})
最后得到:sign=400073a70beecbab91780a9a4973c38f:1502675456531
正式環(huán)境:BASE_URL=http://wap.jnfbg.cn/gateway/pay
測試環(huán)境:BASE_URL=
請求地址:BASE_URL/order?sign={sign}
其中,sign見(jiàn)【1.2簽名算法】計算部分。
需要注意的是,sign不在請求列表參數中,而是放在URL當中(以下所有交易均如此)。被掃支付即B掃C,商戶(hù)掃描顧客手機上的條碼碼然后發(fā)起支付。被掃接口超時(shí)時(shí)間80秒,如果80秒內沒(méi)有完成支付,本次交易訂單會(huì )自動(dòng)撤銷(xiāo)。該交易為同步交易。
注意:請求地址中,{sign}中的{}無(wú)需上送,這里的{sign}是一個(gè)整體,意思是算出來(lái)的簽名,以下與此類(lèi)似。
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 是否可為空 | 樣例 |
busi_id | 商戶(hù)編號 | String(32) | 商戶(hù)編號由平臺統一分配 | 不可空 | 0010000001 |
operator_id | 操作員編號 | String(32) | 操作員編號 | 可空 | oper01 |
terminal_id | 設備編號 | String(32) | 設備編號 | 可空 | dev01 |
merchant_param | 用戶(hù)參數 | String(127) | 用戶(hù)參數,采用base64編碼,接口返回原樣返回 | 可空 | 01000001 |
store_id | 門(mén)店編號 | String(32) | 門(mén)店編號 | 可空 | 02016 |
total_fee | 交易金額 | Integer | 以分為單位 | 不可空 | 158 |
discount_amount | 可打折金額 | Integer | 以分為單位 | 目前兩個(gè)字段暫時(shí)未用到 | |
undiscount_amount | 不可打折金額 | Integer | 以分為單位 | ||
channel_type | 支付渠道 | Integer | 請參見(jiàn) “附錄2支付渠道字典”(傳0自動(dòng)判定渠道) | 不可空 | 0 |
auth_code | 支付用戶(hù)動(dòng)態(tài)碼 | String(100) | 支付寶微信錢(qián)包用戶(hù)動(dòng)態(tài)碼(通過(guò)掃描獲得) | 不可空 | 284214903060794755 |
out_trade_no | 交易上行流水號 | String(32) | 商戶(hù)交易上行流水號(需要唯一) | 不可空 | 20150324001069125999 |
pay_subject | 支付描述信息 | String(100) | 支付描述信息 | 不可空 | 二維碼產(chǎn)品支付 |
fee_type | 幣種。默認CNY。 | String(10) | 貨幣類(lèi)型 | 不可空 | CNY,支持泰銖THB |
time_zone | 時(shí)區 | String(64) | 交易所在地的時(shí)區 | 可為空 | 默認:中國標準時(shí)間;Asia/Shanghai;+08:00 |
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 樣例 |
result | 請求結果 | Object | 請求接口響應碼。節點(diǎn)子節點(diǎn)包括: return_code:返回代碼。詳情參見(jiàn) “附錄5返回代碼數據字典” return_msg:返回消息 | 請參見(jiàn) “2.5返回樣例” |
return_code | 響應代碼 | String | SUCCESS/FAIL | |
return_msg | 響應信息 | String | ||
data部分,當result.return_code=SUCCESS是data部分才有內容 | ||||
return_code | 操作代碼 | String | SUCCESS/FAIL | |
return_msg | 操作信息 | String | date對象return_code=FAIL的原因說(shuō)明 | SOUNDWAVE_PARSER_FAIL |
channel_type | 支付渠道 | Integer | 請參見(jiàn) “附錄2支付渠道字典” | 1 |
out_trade_no | 交易上行流水號 | String | 商戶(hù)交易上行流水號 | 20150324001069125999 |
trade_no | 交易下行流水號 | String | 平臺交易流水號 | 1435736619488 |
channel_trade_no | 渠道流水號 | String | 渠道流水號,支付寶、微信或其他交易渠道的流水號 | 2088110245121545154 |
phone_code | 手機碼 | String | 支付完成后,手機上顯示的商戶(hù)訂單號,各個(gè)渠道有所區別 | 175580212567201710254130450135 |
auth_code | 授權碼 | String | 上送的授權碼,原樣返回 | |
merchant_param | 用戶(hù)參數 | String | 用戶(hù)參數,采用base64編碼,接口返回原樣返回 | 01000001 |
operator_id | 操作員編號 | String | 操作員編號 | oper01 |
terminal_id | 設備編號 | String | 設備編號 | dev01 |
begin_time | 交易時(shí)間 | String | 交易時(shí)間yyyyMMddHHmmss | 20170711145955 |
end_time | 結束時(shí)間 | String | 結束時(shí)間yyyyMMddHHmmss | 20170711150000 |
total_fee | 交易金額 | Integer | 以分為單位 | 158 |
fee_type | 貨幣類(lèi)型 | String | ||
fee_type | 貨幣類(lèi)型 | String | ||
exchange_rate | 匯率 | String | 如果fee_type不等于CNY,則該字段為fee_type對應的當日匯率,元為單位(一些匯率會(huì )精確到分的下一位甚至更多,不宜采用整型數據) | 4.93 |
trans_amount_cny | 人民幣扣款金額 | Integer | 單位為分,fee_type不為CNY時(shí),通過(guò)匯率轉換后得到的人民幣支付金額。 | |
state | 交易狀態(tài) | Integer | ||
credit | 借貸記標識 | String | 借貸標識??蛇x值: credit:信用卡 pcredit:花唄(僅支付寶) debit:借記卡 balance:余額 unknown:未知 |
|
time_zone | 時(shí)區 | String(64) | 交易所在地的時(shí)區 |
請求地址:BASE_URL/preOrder?sign={sign}
該交易有兩種模式,一種是二維碼由我方生成,合作方獲得二維碼后,進(jìn)行展示即可。另外一種是,商戶(hù)按照支付寶微信的授權流程獲取appid或者openid等相關(guān)參數發(fā)起預下單,然后按照支付寶微信的官網(wǎng)發(fā)起JSAPI支付。五分鐘內,該筆交易未完成,后臺會(huì )發(fā)起撤單交易。
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 是否可為空 | 樣例 |
busi_id | 商戶(hù)編號 | String(32) | 商戶(hù)編號由平臺統一分配 | 不可空 | 0010000001 |
operator_id | 操作員編號 | String(32) | 操作員編號 | 可空 | oper01 |
merchant_param | 用戶(hù)參數 | String(127) | 用戶(hù)自定義參數,采用BASE64編碼,接口返回原樣返回 | 可空 | 01000001 |
store_id | 門(mén)店編號 | String(32) | 門(mén)店編號 | 可空 | 02016 |
total_fee | 交易金額 | Integer | 以分為單位 | 不可空 | 158 |
channel_type | 支付渠道 | Integer | 請參見(jiàn) “附錄2支付渠道字典”(trade_type=QRCODE時(shí)傳0自動(dòng)判定渠道) | 不可空 | 0 |
busi_id | 商戶(hù)編號 | String(32) | 商戶(hù)編號由平臺統一分配 | 不可空 | 0010000001 |
out_trade_no | 交易上行流水號 | String(50) | 商戶(hù)交易上行流水號(需要唯一) | 不可空 | 20150324001069125999 |
pay_subject | 支付描述信息 | String(100) | 支付描述信息 | 不可空 | 二維碼產(chǎn)品支付 |
fee_type | 交易幣種 | String(32) | 貨幣類(lèi)型 | 不可空 | CNY |
openId | 用戶(hù)標識,消費者用戶(hù)標識。 | String(10) | 支付寶alipayid或者微信openId | 可空 | 類(lèi)型為JSAPI 必須填寫(xiě) |
openId---用戶(hù)標識,消費者用戶(hù)標識。備注:
1.支付寶支付時(shí),要求上送用戶(hù)在支付寶唯一用戶(hù)號user_id,獲取流程請參考:https://doc.open.alipay.com/docs/doc.htm?treeId=220&articleId=105337&docType=1#s5 2.微信支付時(shí),要求上送用戶(hù)在合作方subAppid下唯一標識openid,獲取流程請參考:http://mp.weixin.qq.com/wiki/17/c0f37d5704f0b64713d5d2c37b468d75.html |
|||||
notifyUrl | 交易通知地址。 | String(10) | 商戶(hù)的交易通知地址 | 可空 | |
subAppId | 微信APPID | String(10) | 如為微信JSAPI支付,則必填 | 可空 | 類(lèi)型為JSAPI 必須填寫(xiě) |
trade_type | 交易類(lèi)型 | String(10) | QRCODE:一碼付JSAPI:JSAPI支付 | 可空 | 默認JSAPI |
time_expire | 超時(shí)時(shí)間 | Integer | 訂單有效期。指定訂單的支付有效時(shí)間(以分鐘計算),超過(guò)有效時(shí)間用戶(hù)將無(wú)法支付。取值范圍為:1-1440 | 可空 | 默認五分鐘 |
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區-1440 | 可為空 |
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 樣例 |
result | 請求結果 | Object | 請求接口響應碼。節點(diǎn)子節點(diǎn)包括: return_code:返回代碼。詳情參見(jiàn) “附錄5返回代碼數據字典” return_msg:返回消息 | 請參見(jiàn) “3.5返回樣例” |
return_code | 響應代碼 | String | SUCCESS/FAIL | |
return_msg | 響應信息 | String | ||
data部分,當result.return_code=SUCCESS是data部分才有內容 | ||||
return_msg | 操作信息 | String | date對象return_code=FAIL的原因說(shuō)明 | SOUNDWAVE_PARSER_FAIL |
trade_no | 交易下行流水號 | String | 平臺返回的交易流水號 | 1435736619488 |
out_trade_no | 交易流水號 | String | 商戶(hù)交易上行流水號(需要唯一) | 20150324001069125999 |
prePayId | 支付寶交易號 | String | 支付寶交易號 | 2015042321001004720200028594 |
payInfo | 微信支付參數 | String | 微信公眾號支付參數 | 見(jiàn)下一行 |
payInfo示例: {"appId":"wx17e91dae2802695e","timeStamp":"1502466163850", "status":"0","signType":"MD5",
"package":"prepay_id=wx20170811234243933827008d0347249 790","callback_url":null,"nonceStr": "1502466163850","paySign":"A844D51548F5460847BBBCC1C864F317"} |
||||
qr_code | 一碼付地址 | String | 一碼付地址,商戶(hù)把改地址顯示成二維碼讓用戶(hù)用支付寶或者微信掃 | http://wap.jnfbg.cn/online/pay/?id=733010020151348& tradeNo=20170811100000235332&price=0.01 |
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區 |
第一種情況,一碼付請求的支付返回:
第二種情況,支付寶JSAPI支付的返回:
第三種情況,微信JSAPI支付的返回:
創(chuàng )建訂單+JSAPI喚起收銀臺支付在線(xiàn)文檔:
https://doc.open.alipay.com/docs/doc.htm?&docType=1&articleId=105591
微信H5 API接口地址如下:
https://pay.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=7_7&index=6
目前該交易僅發(fā)生在主掃支付模式下。當平臺接收到后端支付渠道的通知后,會(huì )向合作方提供的notifyUrl發(fā)起支付通知,通知URL為【2.2主掃交易】中提供的notifyUrl字段。outNofityUrl=notifyUrl?sign={sign}
商戶(hù)接收到通知后(返回字符串SUCCESS)停止通知,否則輪詢(xún)通知5(返回字符串SUCCESS)中斷,間隔5秒。如果用戶(hù)已經(jīng)支付但商戶(hù)端沒(méi)有收到通知的情況下,需要商戶(hù)端主動(dòng)調用查詢(xún)接口獲取訂單狀態(tài)。
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 樣例 |
result | 請求結果 | Object | 請求接口響應碼。節點(diǎn)子節點(diǎn)包括: return_code:返回代碼。詳情參見(jiàn) “附錄5返回代碼數據字典” return_msg:返回消息 | 請參見(jiàn) “3.5返回樣例” |
return_msg | 響應信息 | String | ||
data | 響應數據 | Object | ||
busi_id | 商戶(hù)號 | String | 平臺分配的商戶(hù)號 | |
channel_trade_no | 渠道訂單號 | String | 后端渠道的訂單號 | |
trade_no | 交易下行流水號 | String | 平臺返回的交易流水號 | 1435736619488 |
out_trade_no | 交易流水號 | String | 商戶(hù)交易上行流水號(需要唯一) | 20150324001069125999 |
phone_code | 手機碼 | String | 支付完成后,手機上顯示的商戶(hù)訂單號,各個(gè)渠道有所區別 | 175580212567201710254130450135 |
operator_id | 操作員編號 | String | 操作員編號 | oper01 |
terminal_id | 設備編號 | String | 設備編號 | dev01 |
merchant_param | 商戶(hù)自定義參數 | String | 商戶(hù)在發(fā)起交易是上送的自定義參數 | |
begin_time | 交易時(shí)間 | String | 交易時(shí)間yyyyMMddHHmmss | 20170711145955 |
end_time | 結束時(shí)間 | String | 結束時(shí)間yyyyMMddHHmmss | 20170711150000 |
total_fee | 交易金額 | Integer | 以分為單位 | 158 |
fee_type | 貨幣類(lèi)型 | String | 默認 | CNY |
exchange_rate | 匯率 | String | 如果fee_type不等于CNY,則該字段為fee_type對應的當日匯率,元為單位(一些匯率會(huì )精確到分的下一位甚至更多,不宜采用整型數據) | 4.93 |
trans _amount_cny | 人民幣扣款金額 | Integer | 單位為分,fee_type不為CNY時(shí),通過(guò)匯率轉換后得到的人民幣支付金額。 | |
credit String | 借貸記標識 | String | 借貸標識??蛇x值: credit:信用卡 pcredit:花唄(僅支付寶) debit:借記卡 balance:余額 unknown:未知 |
|
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區 |
請求地址:BASE_URL/refund?sign={sign}
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 是否可為空 | 樣例 |
busi_id | 商戶(hù)編號 | String | 商戶(hù)編號由平臺分配 | 不可空 | 0010000001 |
operator_id | 操作員編號 | String | 操作員編號 | 不可空 | oper01 |
terminal_id | 設備編號 | String | 設備編號 | 不可空 | dev01 |
refund_fee | 退款金額 | Integer | 以分為單位,退款金額不能大于本金 | 不可空 | 158 |
refund_subject | 退款描述 | String | 退款描述 | 不可空 | 商戶(hù)退款 |
out_trade_no | 交易上行流水號 | String | 上行流水號(需要唯一) | 可空(二選一) | 20150324001069125999 |
trade_no | 交易下行流水號 | String | 平臺返回下行流水號(和上行流水號二選一,有下行流水號優(yōu)先使用下行流水號退款) | 可空(二選一) | 1435736619488 |
out_refund_no | 退款流水號 | String | 商戶(hù)退款流水號(需要唯一) | 不可空 | 20150324001069125999 |
fee_type | 幣種。默認CNY。 | String(10) | 貨幣類(lèi)型 | 不可空 | CNY |
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區 | 可為空 |
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 樣例 |
result | 請求結果 | Object | 請求接口響應碼。節點(diǎn)子節點(diǎn)包括: return_code:返回代碼。詳情參見(jiàn) “附錄5返回代碼數據字典” return_msg:返回消息 | 請參見(jiàn) “2.6返回樣例” |
return_code | 響應代碼 | String | SUCCESS/FAIL | |
return_msg | 響應信息 | String | ||
data部分,當result.return_code=SUCCESS是data部分才有內容 | ||||
return_code | 操作代碼 | String | SUCCESS/FAIL | |
return_msg | 操作信息 | String | Return_code=FAIL的原因說(shuō)明 | SOUNDWAVE_PARSER_FAIL |
out_trade_no | 交易上行流水號 | String | 商戶(hù)交易上行流水號 | 20150324001069125999 |
trade_no | 交易下行流水號 | String | 平臺交易流水號 | 1435736619488 |
out_refund_no | 退款流水號 | String | 原樣返回 | |
operator_id | 操作員編號 | String | 操作員編號 | oper01 |
terminal_id | 設備編號 | String | 設備編號 | dev01 |
begin_time | 交易時(shí)間 | String | 交易時(shí)間yyyyMMddHHmmss | 20170711145955 |
end_time | 結束時(shí)間 | String | 結束時(shí)間yyyyMMddHHmmss | 20170711150000 |
refund_fee | 交易金額 | Integer | 以分為單位 | 158 |
fee_type | 貨幣類(lèi)型 | String | ||
exchange_rate | 匯率 | String | 如果fee_type不等于CNY,則該字段為fee_type對應的當日匯率,元為單位(一些匯率會(huì )精確到分的下一位甚至更多,不宜采用整型數據) | 4.93 |
refund_amount_cny | 人民幣扣款金額 | Integer | 單位為分,fee_type不為CNY時(shí),通過(guò)匯率轉換后得到的人民幣支付金額。 | |
channel_type | 支付渠道 | Integer | 請參見(jiàn) “附錄2支付渠道字典”(傳0自動(dòng)判定渠道) | 不可空 |
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區 |
請求地址:BASE_URL/query?sign={sign}
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 是否可為空 | 樣例 |
busi_id | 商戶(hù)編號 | String | 商戶(hù)編號由平臺分配 | 不可空 | 0010000001 |
out_trade_no | 交易上行流水號 | String | 上行流水號(需要唯一) | 不可空 | 20150324001069125999 |
trade_no | 交易下行流水號 | String | 平臺返回下行流水號(和上行流水號二選一,有下行流水號優(yōu)先使用下行流水號退款) | 可空 | 1435736619488 |
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區 | 可空 |
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 樣例 |
result | 請求結果 | Object | 請求接口響應碼。節點(diǎn)子節點(diǎn)包括: return_code:返回代碼。詳情參見(jiàn) “附錄5返回代碼數據字典” return_msg:返回消息 | 請參見(jiàn) “2.6返回樣例” |
return_code | 響應代碼 | String | SUCCESS/FAIL | |
return_msg | 響應信息 | String | ||
data部分,當result.return_code=SUCCESS是data部分才有內容 | ||||
return_code | 操作代碼 | String | SUCCESS/FAIL | |
return_msg | 操作信息 | String | Return_code=FAIL的原因說(shuō)明 | SOUNDWAVE_PARSER_FAIL |
channel_type | 支付渠道 | Integer | 請參見(jiàn) “附錄2支付渠道字典” | 1 |
out_trade_no | 交易上行流水號 | String | 商戶(hù)交易上行流水號 | 20150324001069125999 |
trade_no | 交易下行流水號 | String | 平臺交易流水號 | 1435736619488 |
phone_code | 手機碼 | String | 支付完成后,手機上顯示的商戶(hù)訂單號,各個(gè)渠道有所區別 | 175580212567201710254130450135 |
auth_code | 授權碼 | String | 上送的授權碼,原樣返回 | |
channel_trade_no | 渠道流水號 | String | 渠道流水號,支付寶、微信或其他交易渠道的流水號 | 2088110245121545154 |
merchant_param | 用戶(hù)參數 | String | 用戶(hù)參數,采用base64編碼,接口返回原樣返回 | 01000001 |
operator_id | 操作員編號 | String | 操作員編號 | oper01 |
terminal_id | 設備編號 | String | 設備編號 | dev01 |
begin_time | 交易時(shí)間 | String | 交易時(shí)間yyyyMMddHHmmss | 20170711145955 |
end_time | 結束時(shí)間 | String | 結束時(shí)間yyyyMMddHHmmss | 20170711150000 |
refund_fee | 交易金額 | Integer | 以分為單位 | 158 |
fee_type | 貨幣類(lèi)型 | String | ||
exchange_rate | 匯率 | String | 如果fee_type不等于CNY,則該字段為fee_type對應的當日匯率,元為單位 | 4.93 |
refund_amount_cny | 人民幣扣款金額 | Integer | 單位為分,fee_type不為CNY時(shí),通過(guò)匯率轉換后得到的人民幣支付金額。 | |
credit | 借貸記標識 | String | 借貸標識??蛇x值: credit:信用卡 pcredit:花唄(僅支付寶) debit:借記卡 balance:余額 unknown:未知 |
|
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區 |
請求地址:BASE_URL/cancel?sign={sign}
本接口針對刷卡支付(被掃)模式,用戶(hù)長(cháng)時(shí)間未等到訂單終態(tài)或者一直超時(shí),調用本接口撤銷(xiāo)訂單。當認定該訂單已支付成功或支付失敗,則撤銷(xiāo)失敗。調用訂單撤銷(xiāo)前請先進(jìn)行訂單查詢(xún)。
最早可撤銷(xiāo)時(shí)間在訂單創(chuàng )建之后15秒后
撤銷(xiāo)交易需要控制在1:00—23:00,其余時(shí)間不允許進(jìn)行撤銷(xiāo)交易。
一般而言,沒(méi)有特殊需求,不建議發(fā)起該交易。如確實(shí)有該需求,請與我方開(kāi)發(fā)人員進(jìn)行溝通。
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 是否可為空 | 樣例 |
busi_id | 商戶(hù)編號 | String | 商戶(hù)編號由平臺分配 | 不可空 | 0010000001 |
operator_id | 操作員編號 | String | 操作員編號 | 不可空 | oper01 |
terminal_id | 設備編號 | String | 設備編號 | 不可空 | dev01 |
out_trade_no | 交易上行流水號 | String | 上行流水號(需要唯一) | 不可空 | 20150324001069125999 |
trade_no | 交易下行流水號 | String | 平臺返回下行流水號(和上行流水號二選一,有下行流水號優(yōu)先使用下行流水號退款) | 可空 | 1435736619488 |
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區 | 可空 |
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 樣例 |
result | 請求結果 | Object | 請求接口響應碼。節點(diǎn)子節點(diǎn)包括: return_code:返回代碼。詳情參見(jiàn) “附錄5返回代碼數據字典” return_msg:返回消息 | 請參見(jiàn) “2.6返回樣例” |
return_code | 響應代碼 | String | SUCCESS/FAIL | |
return_msg | 響應信息 | String | ||
data部分,當result.return_code=SUCCESS是data部分才有內容 | ||||
return_code | 操作代碼 | String | SUCCESS/FAIL | |
return_msg | 操作信息 | String | Return_code=FAIL的原因說(shuō)明 | SOUNDWAVE_PARSER_FAIL |
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區 |
請求地址:BASE_URL/close?sign={sign}
該接口針對主掃模式,當訂單創(chuàng )建后,消費者長(cháng)時(shí)間未付款,合作方可通過(guò)本接口關(guān)閉訂單。
如果訂單未支付,關(guān)閉訂單;
如果訂單已經(jīng)成功或支付失敗,無(wú)法關(guān)閉,返回訂單已成功或已失敗。
一般而言,沒(méi)有特殊需求,不建議發(fā)起該交易。如確實(shí)有該需求,請與我方開(kāi)發(fā)人員進(jìn)行溝通。
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 是否可為空 | 樣例 |
busi_id | 商戶(hù)編號 | String | 商戶(hù)編號由平臺分配 | 不可空 | 0010000001 |
operator_id | 操作員編號 | String | 操作員編號 | 不可空 | oper01 |
terminal_id | 設備編號 | String | 設備編號 | 不可空 | dev01 |
out_trade_no | 交易上行流水號 | String | 上行流水號,原訂單的外部訂單號 | 不可空 | 20150324001069125999 |
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區 | 可空 |
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 樣例 |
result | 請求結果 | Object | 請求接口響應碼。節點(diǎn)子節點(diǎn)包括: return_code:返回代碼。詳情參見(jiàn) “附錄5返回代碼數據字典” return_msg:返回消息 | 請參見(jiàn) “2.6返回樣例” |
return_code | 響應代碼 | String | SUCCESS/FAIL | |
return_msg | 響應信息 | String | ||
data部分,當result.return_code=SUCCESS是data部分才有內容 | ||||
return_code | 操作代碼 | String | SUCCESS/FAIL | |
return_msg | 操作信息 | String | Return_code=FAIL的原因說(shuō)明 | |
out_trade_no | 外部訂單號 | String | 原樣返回 | |
trade_no | 平臺訂單號 | String | ||
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區 |
請求地址:BASE_URL/refundQuery?sign={sign}
該接口提供退款交易的結果回查功能。
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 是否可為空 | 樣例 |
busi_id | 商戶(hù)編號 | String | 商戶(hù)編號由平臺分配 | 不可空 | 0010000001 |
operator_id | 操作員編號 | String | 操作員編號 | 不可空 | oper01 |
terminal_id | 設備編號 | String | 設備編號 | 不可空 | dev01 |
out_trade_no | 原商戶(hù)退款流水號 | String | 原來(lái)商戶(hù)發(fā)起退款交易上送的退款的流水號 | 不可空 | 20150324001069125999 |
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區 | 可空 |
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 樣例 |
result | 請求結果 | Object | 請求接口響應碼。節點(diǎn)子節點(diǎn)包括: return_code:返回代碼。詳情參見(jiàn) “附錄5返回代碼數據字典” return_msg:返回消息 | 請參見(jiàn) “2.6返回樣例” |
return_code | 響應代碼 | String | SUCCESS/FAIL | |
return_msg | 響應信息 | String | ||
data部分,當result.return_code=SUCCESS是data部分才有內容 | ||||
return_code | 操作代碼 | String | SUCCESS/FAIL | |
return_msg | 操作信息 | String | Return_code=FAIL的原因說(shuō)明 | |
out_trade_no | 商戶(hù)退款單號 | String | 原樣返回 | |
trade_no | 平臺訂單號 | String | ||
trade_status | 退款狀態(tài) | String | 1、 成功:succ 2、 失?。篺ail 3、 退款中:refunding |
|
以下字段僅當trade_status=succ時(shí)有返回 | ||||
refund_fee | 退款金額 | Integer | 退款金額,單位為分 | |
refund_subject | 退款原因 | String | 原退款交易上送的退款原因 | |
gmt_refund_time | 退款完成時(shí)間 | String | 退款完成時(shí)間,時(shí)間格式yyyyMMddHHmmss | |
operator_id | 操作員編號 | String | 操作員編號 | |
terminal_id | 設備編號 | String | 設備編號 | |
time_zone | 時(shí)區 | String | 交易所在地的時(shí)區 |
參數 | 參數名稱(chēng) | 類(lèi)型 | 參數說(shuō)明 | 是否可為空 | 樣例 |
good_id | 商品ID | String | 商品ID | 不可空 | 2010 |
good_name | 商品名稱(chēng) | String | 商品名稱(chēng) | 不可空 | Iphone |
good_class | 商品分類(lèi) | String | 設備編碼 | 不可空 | 手機 |
good_price | 商品金額 | String | 以元為單位 | 不可空 | 4999.00 |
good_subject | 商品簡(jiǎn)介 | String | 請參見(jiàn)“支付渠道附錄” | 不可空 | 數碼產(chǎn)品 |
good_quantity | 商品數量 | String | 需要唯一 | 不可空 | 1 |
good_showurl | 商品展示網(wǎng)址 | String | 商品展示地址 | 可空 | wap.jnfbg.cn |
支付渠道代碼 | 支付渠道 |
0 | 被掃接口傳0自動(dòng)判定渠道 |
1 | 支付寶 |
2 | 微信 |
付款渠道代碼 | 付款渠道 |
00 | 支付寶紅包 |
10 | 支付寶余額 |
60 | 支付寶預存卡 |
30 | 支付寶集分寶 |
70 | 支付寶信用支付 |
40 | 折扣券 |
80 | 預付卡 |
90 | 信用支付(消費信貸) |
11 | 微信支付 |
41 | 微信現金券支付 |
訂單狀態(tài) | 含義 |
0 | 待付款 |
1 | 已付款 |
2 | 已撤單 |
3 | 申請撤單 |
4 | 部分退款 |
5 | 已退款 |
6 | 交易關(guān)閉 |
7 | 系統保留狀態(tài)(查詢(xún)時(shí)使用,同時(shí)查詢(xún)退款和撤單記錄) |
8 | 退款中(平臺未返回退款結果) |
9 | 退款失敗 |
10 | 待退款 |
11 | 退款成功 |
12 | 退款失敗 |
13 | 退款取消 |
14 | 撤單成功 |
訂單狀態(tài) | 含義 |
SUCESS | 成功 |
FAIL | 失敗 |
ILLEGAL_PARAMETER | 參數錯誤 |
INVALID_SIGN | 簽名錯誤 |
AMT_ERROR | 金額錯誤 |
DATABASE_ERROR | 數據庫連接異常 |
INVALID_CONTRACT | 無(wú)效的簽約狀態(tài) |
UNREGISTERED_BUSI | 未注冊的商戶(hù) |
EXCEPTION | 未知異常 |
CHARGE_NONEXISTENT | 交易記錄不存在 |
SERVICE_UNAVAILABLE | 服務(wù)不可用 |
HTTP_EXCEPTION | HTTP請求異常 |
IO_EXCEPTION | IO異常 |
CREATE_SECURITY_CONNECTION_ERROR | 創(chuàng )建安全鏈接失敗 |
AREADY_REVOKED | 該訂單已經(jīng)撤銷(xiāo) |
SERIAL_REPEAT | 上行流水號與系統中重復 |
Copyright ? 2006~ ffdzpay.com All Rights Reversed. 付付得正 ICP備案號:浙ICP備17034167號