網路商店購物車金流串接
網址連結
- 正式: https://www.paynow.com.tw/service/etopm.aspx
- 測試: https://test.paynow.com.tw/service/etopm.aspx
- 正式、測試環境為個別獨立空間,帳號需個別申請,無法共通使用
注意事項
商家啟用各項服務後,請至商家專區更改每一服務對應之交易成功回傳網址及交易失敗回傳網址,日後交易將針對不同服務,回傳至對應網站
範例
若商家設定信用卡服務的回傳網址為:
http://www.yourdomain.com.tw/card_callback.aspx
當使用信用卡及WebATM等線上即時服務做交易時,回傳網頁將為:
http://www.yourdomain.com.tw/card_callback.aspx
※ 若交易當下系統無法取得向銀行發送授權時所必須的資料,將可能跳轉至PayNow的錯誤回覆頁面;其他授權結果皆會回傳至商家設定回傳網址
※ 本文所提及之商家交易碼皆為「賣場網站交易密碼」
退款須知:請慎用退款機制,避免連續退款、異常退款⋯等行為產生,此類行將可能被銀行視為信用、異常交易問題,PayNow將會停止您的帳號服務
一般交易串接
Version: V1.7.1.0
前言
有關網路商店購物車金流串接技術文件,共分一本串接技術文件,其中包含第一、二部份交易傳送及回傳
串接技術文件,主要在於說明各部份串接的用意與功能(此部分為網路商店購物車金流必要之串接作業)
當第一部份串接完成時,您的EC平台即可以開始接受線上交易包含信用卡、WebATM、虛擬帳號轉帳
功能說明
- 即時交易傳送
- 信用卡、WbeAtm、虛擬帳號轉帳的交易及時傳送給PayNow平台
- 即時交易回傳
- PayNow平台接收到EC平台傳送之信用卡、WebATM交易後,將銀行回復結果即時回復給EC平台
訊息傳送介面、回傳
說明
- 使用者在此頁面選擇取貨門市,選擇完畢後回傳門市資訊至帶入的回傳網址
傳遞方式:Http POST method
Request
◎ 付款方式為信用卡、WebATM、虛擬帳號、超商代收、銀聯卡
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
WebNo | 統編/身分證 | string | 10 | Y | 賣家登入帳號,如身分證開頭請為大寫傳送 |
PassCode | 傳遞碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo + OrderNo + TotalPrice + apicode並使用sha-1雜湊函數取得組合字串的雜湊值附錄 | |
ReceiverName | 消費者姓名 | string | 20 | Y | 不可為數字 |
ReceiverID | 消費者ID | string | 50 | Y | 消費者身分證/Email/手機號碼 |
ReceiverTel | 消費者電話 | string | 20 | Y | 若沒有手機可填入聯絡電話Ex:0225063733;0913123456 |
ReceiverEmail | 消費者Email | string | Y | 需符合Email規格 | |
OrderNo | 商家自訂訂單編號 | string | 50 | Y | 不可為中文 |
ECPlatform | EC平台提供商 | string | 100 | Y | 商家網站名稱(例 : XXX購物網、對外商店名稱) |
TotalPrice | 交易金額 | string | Y | 最低交易金額為新台幣$30元(票券交易請帶入可與票券數量整除的總金額) | |
OrderInfo | 商家自訂交易訊息 | string | 200 | Y | 交易內容商家可自訂(5~200字內) |
Note1 | 備註1 | string | 200 | Y | 商家自訂參數 |
Note2 | 備註2 | string | 200 | Y | 商家自訂參數 |
PayType | 付款方式 | string | 2 | Y | 01 : 信用卡 02 : WebATM 03 : 虛擬帳號 05 : 代碼繳費 09 : 銀聯 10 : 超商條碼 11 : 分期付款 |
AtmRespost | 是否需要導頁回傳參數 | string | 1 | N | 0或1;賣家交易需回傳參數請帶入1否則請帶入0。(預設為0) |
DeadLine | 繳款期限 | string | 1 | N | 限數字,部分付款方式適用(ex:超商代收,虛擬帳號);預設為0 |
PayEN | 中英文付款頁面轉換 | string | 1 | N | 0:中文 1:英文 |
CodeType | 代碼繳費服務辨識代號 | string | 1 | Y | 0:ibon(7-11) 1:FamiPort(全家) 2:icash(icash錢包) PayType = 05 時,請帶此參數,預設為0 |
EPT | 系統分系代數 | string | 1 | Y | 固定帶1 |
※店配服務須向PayNow申請設定方可使用
Response
1.1 信用卡、WebATM、銀聯卡、分期付款回傳參數
傳遞方式:Http POST method
參數回傳時會以 URL Encode 編碼,網頁字集為 UTF-8,請以 URL Decode 解碼
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
WebNo | 統編/身分證 | string | Y | 僅用信用卡交易時回傳 | |
BuysafeNo | PayNow訂單編號 | string | 19 | Y | |
PassCode | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo + OrderNo + TotalPrice + 商家交易密碼 + TranStatus並使用sha-1雜湊函數取得組合字串的雜湊值附錄 | |
OrderNo | 商家自訂編號 | string | 50 | Y | 不可為中文 |
TranStatus | 交易結果 | string | 1 | Y | 回傳S代表交易成功;F代表交易失敗 |
ErrDesc | 錯誤描述 | string | 200 | Y | 當TranStatus為F時,將回傳錯誤訊息(失敗原因)於此,TranStatus為S時則無此參數 |
TotalPrice | 交易金額 | string | Y | 整數,30~999999999 | |
Note1 | 備註1 | string | 200 | Y | 商家自訂參數 |
Note2 | 備註2 | string | 200 | Y | 商家自訂參數 |
PayType | 付款方式 | string | 2 | Y | 01 : 信用卡 02 : WebATM 09 : 銀聯 11 : 分期付款 |
pan_no4 | 信用卡末四碼 | string | 4 | Y | 僅用信用卡交易時回傳 |
Card_Foreign | 是否國外卡 | string | 1 | Y | 0:國內卡 1:國外卡 |
installment | 信用卡分期期數 | string | Y | 非分期交易為空值或為1 |
※ 重要訊息:若對應的付款方式回傳值中有其他參數值存在時,可不必理會
1.2 虛擬帳號回傳
說明
- 付款方式為虛擬帳號;回傳方式為離線回傳訊息,如需在交易訂單成立時接收訂單成立結果及回覆參數,請加入參數AtmRespost訊息傳送介面
- 待消費者繳費且我方收到繳費通知後,即傳送相關訊息至商家通知該筆交易成功
- 傳送網址將以商家設定至後台的接收網址為主
參數回傳時會以URL Encode 編碼,網頁字集為 UTF-8,請以 URL Decode 解碼
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
BuysafeNo | PayNow訂單編號 | string | Y | ||
OrderNo | 商家自訂編號 | string | Y | 不可為中文 | |
PassCode | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo(統編/身分證字號) + OrderNo + TotalPrice + 商家交易密碼 + TranStatus並使用sha-1雜湊函數取得組合字串的雜湊值附錄 | |
Note1 | 備註1 | string | Y | 商家自訂參數 | |
Note2 | 備註2 | string | Y | 商家自訂參數 | |
TotalPrice | 交易金額 | string | Y | 整數,30~999999999 | |
PayType | 付款方式 | string | 2 | Y | 03 : 虛擬帳號 |
ATMNo | 虛擬帳號號碼 | string | Y | 繳款唯一編號 | |
NewDate | 產生日期(繳款日) | string | Y | 虛擬帳號產生日期(繳款日)(格式:yyyy/mm/ddhh:mm:ss) | |
DueDate | 繳款期限 | string | Y | 虛擬帳號繳款期限 (yyyy/mm/dd) | |
TranStatus | 繳款狀態 | string | 1 | Y | 回傳S代表繳款成功;F代表未繳款 |
BankCode | 銀行代碼 | string | Y | ||
BranchCode | 分行代碼 | string | Y |
1.3 四大超商條碼代收交易回傳
說明
- 付款方式為超商代收;回傳方式為離線回傳訊息
- 待消費者繳費且我方收到繳費通知後,即傳送相關訊息至商家通知該筆交易成功
- 傳送網址將以商家設定至後台的接收網址為主
參數回傳時會以URL Encode 編碼,網頁字集為 UTF-8,請以 URL Decode 解碼
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
BuysafeNo | PayNow訂單編號 | string | 19 | Y | |
OrderNo | 商家自訂編號 | string | 50 | Y | 不可為中文 |
PassCode | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo(統編/身分證字號) + OrderNo + TotalPrice + 商家交易密碼 + TranStatus並使用sha-1雜湊函數取得組合字串的雜湊值附錄 | |
TotalPrice | 交易金額 | string | Y | 整數,30~999999999 | |
PayType | 付款方式 | string | 2 | Y | 10 : 商家代收條碼繳費 |
BarCode1 | 條碼1 | string | Y | Code39條碼文數字 | |
BarCode2 | 條碼2 | string | Y | Code39條碼文數字 | |
BarCode3 | 條碼3 | string | Y | Code39條碼文數字 | |
NewDate | 產生日期(繳款日) | string | Y | 超商條碼產生日期(繳款日)(格式:yyyy/mm/ddhh:mm:ss) | |
DueDate | 繳款期限 | string | Y | 超商條碼繳款期限 (yyyy/mm/dd) | |
TranStatus | 繳款狀態 | string | 1 | Y | 回傳S代表繳款成功;F代表未繳款 |
1.4 ibon/FamiPort/iCash錢包交易回傳
說明
- 付款方式為超商代收;回傳方式為離線回傳訊息
- 待消費者繳費且我方收到繳費通知後,即傳送相關訊息至商家通知該筆交易成功
- 傳送網址將以商家設定至後台的接收網址為主
參數回傳時會以URL Encode 編碼,網頁字集為 UTF-8,請以 URL Decode 解碼
1.4.1 交易產生時回傳
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
BuysafeNo | PayNow訂單編號 | string | 19 | Y | |
OrderNo | 商家自訂編號 | string | 50 | Y | 不可為中文 |
TotalPrice | 交易金額 | string | Y | 整數,30~999999999 | |
PayType | 付款方式 | string | 2 | Y | 05 : ibon/FamiPort/iCash |
icashpayno/IBONNO/FamiPortNo | icash/Ibon/FamiPort繳費代碼 | string | Y | Icash、Ibon或FamiPort代碼 | |
icashpayurl | Icash付款連結 | string | Y | Icash交易,Codytype=2時使用 | |
NewDate | 產生日期(繳款日) | string | Y | Ibon代碼產生日期(繳款日)(格式:yyyy/mm/ddhh:mm:ss) | |
DueDate | 繳款期限 | string | Y | Ibon代碼繳款期限 (yyyy/mm/dd) | |
IdKey | IdKey | string | Y | EC廠商使用,一般串接請忽略 | |
TranStatus | 繳款狀態 | string | 1 | Y | 回傳S代表繳款成功;F代表未繳款 |
PassCode | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo(統編/身分證字號) + OrderNo + TotalPrice + 商家交易密碼並使用sha-1雜湊函數取得組合字串的雜湊值附錄,成功交易回傳時才加上TranStatus | |
PassCode2 | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : PassCode + ReceiverEmail二個參數值並使用sha-1雜湊函數取得組合字串的雜湊值附錄並轉換大寫且僅於成功交易回傳 | |
Note1 | 備註1 | string | Y | 商家自訂參數 | |
Note2 | 備註2 | string | Y | 商家自訂參數 |
1.4.2 交易成功時回傳
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
BuysafeNo | PayNow訂單編號 | string | Y | ||
OrderNo | 商家自訂編號 | string | Y | 不可為中文 | |
TotalPrice | 交易金額 | string | Y | 整數,30~999999999 | |
PayType | 付款方式 | string | 2 | Y | 05 : ibon/FamiPort/iCash |
IdKey | IdKey | string | Y | EC廠商使用,一般串接請忽略 | |
TranStatus | 繳款狀態 | string | 1 | Y | 回傳S代表繳款成功;F代表未繳款 |
PassCode | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo(統編/身分證字號) + OrderNo + TotalPrice + 商家交易密碼 + TranStatus並使用sha-1雜湊函數取得組合字串的雜湊值附錄,成功交易回傳時才加上TranStatus | |
PassCode2 | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : PassCode + ReceiverEmail二個參數值並使用sha-1雜湊函數取得組合字串的雜湊值附錄並轉換大寫且僅於成功交易回傳 | |
Note1 | 備註1 | string | Y | 商家自訂參數 | |
Note2 | 備註2 | string | Y | 商家自訂參數 | |
ErrDesc | 錯誤描述 | string | 200 | Y | 當TranStatus為F時,將回傳錯誤訊息(失敗原因)於此,TranStatus為S時則無此參數 |
一般交易串接-附錄
測試平台網址須知
說明
- 測試平台網址:
https://test.paynow.com.tw
各項服務所對應位置皆與正式平台相同 - 測試帳號:請至
https://test.paynow.com.tw
加入會員,登入帳號即為您的測試帳號 - 測試平台的任何交易除了虛擬帳號不可繳款外,其餘測試都是交易失敗的。
- 接收網頁請串接正確,才能接收失敗 訊息,測試平台與正式平台資料庫...等皆為完全獨立,故待所有程式串接測試完畢後,轉移至正式平台上線前,不可在正式平台進行測試交易,違者將會提出警告並停用賣家帳號,請務必回到
https://www.paynow.com.tw
申請正式會員 - 正式平台與測試平台環境皆相同,正式上線後,同樣需設定相關回傳網址。目前PayNow 開放的服務為信用卡交易、WebATM、虛擬帳號
- WebATM:若非約定帳戶,一日轉帳總金額不可超過3萬。故若您的交易金額大於2萬以上,建議使用信用卡,此付費方式就不會有交易金額的限制
- 退款須知:請慎用退款機制,避免連續退款、異常退款⋯等行為產生,此類行為將可能被銀行視為信用、異常交易問題,PayNow將會停止您的帳號服務
- 如需測試交易行為,請至測試平台,不可在正式平台進行測試退款交易,違者將會提出警告並停用賣家帳號**
- WebATM因安泰銀行不提供測試交易,故測試平台測試時,當畫面正常顯示安泰銀行WebATM網路ATM畫面,測試即算成功(若您發生轉帳動作,請自行負責)
- 虛擬帳號、超商代收付、貨到付款於測試交易時,請核對於畫面上之金額、姓名、交易內容等 是否正確即可,請勿實際繳費(若您發生實際繳費狀況,請自行負責)
- 信用卡測試則無上述問題
- 所有測試平台上之測試交易,皆不會發生實際請款動作,也不會有實際撥款狀況
自動扣款
Version: ACV1.0.0.2
前言
有關網路商店購物車金流串接技術文件,共分一本串接技術文件,其中包含第一、二部份交易傳送及回傳
串接技術文件,主要在於說明各部份串接的用意與功能(此部分為網路商店購物車金流必要之串接作業)
當第一部份串接完成時,您的EC平台即可以開始接受線上交易包含信用卡
功能說明
- 即時交易傳送
- 信用卡交易及時傳送給PayNow平台
- 即時交易回傳
- PayNow平台接收到EC平台傳送信用卡交易後,將銀行回復結果即時回復給EC平台
訊息傳送介面、回傳
說明
- 使用者在此頁面選擇取貨門市,選擇完畢後回傳門市資訊至帶入的回傳網址
傳遞方式:Http POST method
Request
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
WebNo | 統編/身分證 | string | 10 | Y | 賣家登入帳號,如身分證開頭請為大寫傳送 |
PassCode | 傳遞碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo + OrderNo + TotalPrice + apicode並使用sha-1雜湊函數取得組合字串的雜湊值附錄 | |
ReceiverName | 消費者姓名 | string | 20 | Y | 不可為數字 |
ReceiverID | 消費者ID | string | 50 | Y | 消費者身分證/Email/手機號碼 |
ReceiverTel | 消費者電話 | string | 20 | Y | 若沒有手機可填入聯絡電話Ex:0225063733;0913123456 |
ReceiverEmail | 消費者Email | string | Y | 需符合Email規格 | |
OrderNo | 商家自訂訂單編號 | string | 50 | Y | 不可為中文 |
ECPlatform | EC平台提供商 | string | 100 | Y | 商家網站名稱(例:XXX購物網、對外商店名稱) |
TotalPrice | 交易金額 | string | Y | 最低交易金額為新台幣$30元 | |
OrderInfo | 商家自訂交易訊息 | string | 200 | Y | 交易內容商家可自訂(5~200字內) |
Note1 | 備註1 | string | 200 | Y | 商家自訂參數 |
Note2 | 備註2 | string | 200 | Y | 商家自訂參數 |
PayType | 付款方式 | string | 2 | Y | 13:自動扣款授權 |
AtmRespost | 是否需要導頁回傳參數 | string | 1 | N | 0或1;賣家交易需回傳參數請帶入1否則請帶入0。(預設為0) |
DeadLine | 繳款期限 | string | 1 | N | 限數字,部分付款方式適用(ex:超商代收,虛擬帳號);預設為0 |
Installment | 預備繳款期數 | string | 1 | Y | 限數字(1~36) |
PayDay | 授權日 | string | 2 | Y | 01 ~ 31 |
CIFID | UserID | string | 18 | Y | 大小寫有別,最少6碼 |
CIFPW | UserPW | string | 18 | Y | 大小寫有別,最少 6 碼 |
CIFID_SN | SN(序號) | string | 2 | 預存卡號流水號(如果有),系統預設為1 | |
EPT | 系統分系代數 | string | 1 | Y | 固定帶1 |
※ Installment,PayDay,CIFID及CIFPW等參數僅在預存使用;僅做為確認信用卡授權成功並紀錄使用者授權帳號之用途 ※ 預存卡號之交易,CIFID及CIFPW都必須填寫才能做預存,若CIFID_SN無填寫將預設為序號1
Response
1.1 付款方式:信用卡
傳遞方式:Http POST method
參數回傳時會以 URL Encode 編碼,網頁字集為 UTF-8,請以 URL Decode 解碼
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
BuysafeNo | PayNow訂單編號 | string | 19 | Y | |
PassCode | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo + OrderNo + TotalPrice + 商家交易密碼 + TranStatus並使用sha-1雜湊函數取得組合字串的雜湊值附錄PS.請轉大寫 | |
OrderNo | 商家自訂編號 | string | 20 | Y | 不可為中文 |
TranStatus | 交易結果 | string | 1 | Y | 回傳S代表交易成功;F代表交易失敗 |
ErrDesc | 錯誤描述 | string | 200 | Y | 當TranStatus為F時,將回傳錯誤訊息(失敗原因)於此,TranStatus為S時則無此參數 |
TotalPrice | 交易金額 | string | Y | 整數,30~999999999 | |
Note1 | 備註1 | string | 200 | Y | 商家自訂參數 |
Note2 | 備註2 | string | 200 | Y | 商家自訂參數 |
PayType | 付款方式 | string | 2 | Y | 13: 預存授權 |
Installment | 預備繳款期數 | string | 2 | Y | 限數字(1~36) |
PayDay | 授權日 | string | 2 | Y | 預存授權日期 |
CIFID | UserID | string | 18 | Y | 預存授權使用者帳號 |
CIFPW | UserPW | string | 18 | Y | 預存授權使用者密碼 |
CIFID_SN | SN(序號) | string | 2 | 預存卡號流水號 |
※ 重要訊息:若對應的付款方式回傳值中有其他參數值存在時,可不必理會
自動扣款服務-測試平台網址須知
說明
- 測試平台網址:
https://test.paynow.com.tw
各項服務所對應位置皆與正式平台相同 - 測試帳號:請至
https://test.paynow.com.tw
加入會員,登入帳號即為您的測試帳號 - 測試平台的任何測試都是交易失敗的。接收網頁請串接正確.才能接收失敗訊息。
- 測試平台與正式平台資料庫...等皆為完全獨立,故待所有程式串接測試完畢後,轉移至正式平台上線前,不可在正式平台進行測試交易,違者將會提出警告並停用賣家帳號,請務必回到
https://www.paynow.com.tw
申請正式會員 - 正式平台與測試平台環境皆相同,正式上線後,同樣需設定相關回傳網址。目前PayNow開放的服務為信用卡交易
一般票券交易串接
Version: v1.7.0.3
前言
有關網路商店購物車金流串接技術文件,共分一本串接技術文件,其中包含第一、二部份交易傳送及回傳
串接技術文件,主要在於說明各部份串接的用意與功能(此部分為網路商店購物車金流必要之串接作業)
當第一部份串接完成時,您的EC平台即可以開始接受線上交易包含信用卡
功能說明
- 即時交易傳送
- 信用卡、WbeAtm、虛擬帳號轉帳的交易及時傳送給PayNow平台
- 即時交易回傳
- PayNow平台接收到EC平台傳送之信用卡、WebATM交易後,將銀行回復結果即時回復給EC平台
訊息傳送介面、回傳
說明
- 使用者在此頁面選擇取貨門市,選擇完畢後回傳門市資訊至帶入的回傳網址
傳遞方式:Http POST method
Request
◎ 付款方式為信用卡、WebATM、虛擬帳號、超商代收
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
WebNo | 統編/身分證 | string | 10 | Y | 賣家登入帳號,如身分證開頭請為大寫傳送 |
PassCode | 傳遞碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo + OrderNo + TotalPrice + apicode並使用sha-1雜湊函數取得組合字串的雜湊值附錄 | |
ReceiverName | 消費者姓名 | string | 20 | Y | 不可為數字 |
ReceiverID | 消費者ID | string | 50 | Y | 消費者身分證/Email/手機號碼 |
ReceiverTel | 消費者電話 | string | 20 | Y | 若沒有手機可填入聯絡電話Ex:0225063733;0913123456 |
ReceiverEmail | 消費者Email | string | Y | 需符合Email規格 | |
OrderNo | 商家自訂訂單編號 | string | 50 | Y | 不可為中文 |
ECPlatform | EC平台提供商 | string | 100 | Y | 商家網站名稱(例 : XXX購物網、對外商店名稱) |
TotalPrice | 交易金額 | string | Y | 最低交易金額為新台幣$30元(票券交易請帶入可與票券數量整除的總金額) | |
OrderInfo | 商家自訂交易訊息 | string | 200 | Y | 交易內容商家可自訂(5~200字內) |
Note1 | 備註1 | string | 200 | Y | 商家自訂參數 |
Note2 | 備註2 | string | 200 | Y | 商家自訂參數 |
PayType | 付款方式 | string | 2 | Y | 01:信用卡 |
AtmRespost | 是否需要導頁回傳參數 | string | 1 | N | 0或1;賣家交易需回傳參數請帶入1否則請帶入0。(預設為0) |
DeadLine | 繳款期限 | string | 1 | N | 限數字,部分付款方式適用(ex:超商代收,虛擬帳號);預設為0 |
TotalTickets | 票券數量 | string | 2 | N | 限數字,內容僅能為數字,若是票券交易才須帶此參數;分期交易不適用 |
PayEN | 中英文付款頁面轉換 | string | 1 | N | 0:中文 1:英文 |
EPT | 系統分系代數 | string | 1 | Y | 固定帶1 |
※店配服務須向PayNow申請設定方可使用
Response
1.1 信用卡、WebATM、銀聯卡回傳參數
傳遞方式:Http POST method
參數回傳時會以 URL Encode 編碼,網頁字集為 UTF-8,請以 URL Decode 解碼
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
WebNo | 統編/身分證 | string | Y | 僅用信用卡交易時回傳 | |
BuysafeNo | PayNow訂單編號 | string | 19 | Y | 若為票券交易以逗號分隔,ex:8000002102221234567,8000002102221234568,8000002102221234569 |
PassCode | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo + OrderNo + TotalPrice + 商家交易密碼 + TransStatus並使用sha-1雜湊函數取得組合字串的雜湊值附錄 | |
OrderNo | 商家自訂編號 | string | 50 | Y | 不可為中文 |
TranStatus | 交易結果 | string | 1 | Y | 回傳S代表交易成功;F代表交易失敗 |
ErrDesc | 錯誤描述 | string | 200 | Y | 當TranStatus為F時,將回傳錯誤訊息(失敗原因)於此,TranStatus為S時則無此參數 |
TotalPrice | 交易金額 | string | Y | 整數,30~999999999 | |
Note1 | 備註1 | string | 200 | Y | 商家自訂參數 |
Note2 | 備註2 | string | 200 | Y | 商家自訂參數 |
PayType | 付款方式 | string | 2 | Y | 01 : 信用卡 02 : WebATM 03 : 虛擬帳號 |
pan_no4 | 信用卡末四碼 | string | 4 | Y | 僅用信用卡交易時回傳 |
Card_Foreign | 是否國外卡 | string | 1 | Y | 0:國內卡 1:國外卡 |
※ 重要訊息:若對應的付款方式回傳值中有其他參數值存在時,可不必理會
1.2 虛擬帳號回傳
說明
- 付款方式為虛擬帳號;回傳方式為離線回傳訊息,如需在交易訂單成立時接收訂單成立結果及回覆參數,請加入參數AtmRespost訊息傳送介面
- 待消費者繳費且我方收到繳費通知後,即傳送相關訊息至商家通知該筆交易成功
- 傳送網址將以商家設定至後台的接收網址為主
參數回傳時會以URL Encode 編碼,網頁字集為 UTF-8,請以 URL Decode 解碼
重點提示:參數傳送時,將以逗點分隔(csv)傳送,詳細資料請參閱範例
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
BuysafeNo | PayNow訂單編號 | string | 19 | Y | |
OrderNo | 商家自訂編號 | string | 50 | Y | 不可為中文 |
PassCode | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo(統編/身分證字號) + OrderNo + TotalPrice + 商家交易密碼並使用sha-1雜湊函數取得組合字串的雜湊值附錄 | |
Note1 | 備註1 | string | Y | 商家自訂參數 | |
Note2 | 備註2 | string | Y | 商家自訂參數 | |
TotalPrice | 交易金額 | string | Y | 整數,30~999999999 | |
PayType | 付款方式 | string | 2 | Y | 03 : 虛擬帳號 |
ATMNo | 虛擬帳號號碼 | string | Y | 繳款唯一編號 | |
NewDate | 產生日期(繳款日) | string | Y | 虛擬帳號產生日期(繳款日)(格式:yyyy/mm/ddhh:mm:ss) | |
DueDate | 繳款期限 | string | Y | 虛擬帳號繳款期限 (yyyy/mm/dd) | |
TranStatus | 繳款狀態 | string | 1 | Y | 回傳S代表繳款成功;F代表未繳款 |
1.3 四大超商條碼代收交易回傳
說明
- 付款方式為超商代收;回傳方式為離線回傳訊息
- 待消費者繳費且我方收到繳費通知後,即傳送相關訊息至商家通知該筆交易成功
- 傳送網址將以商家設定至後台的接收網址為主
參數回傳時會以URL Encode 編碼,網頁字集為 UTF-8,請以 URL Decode 解碼
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
BuysafeNo | PayNow訂單編號 | string | 19 | Y | |
OrderNo | 商家自訂編號 | string | 50 | Y | 不可為中文 |
PassCode | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo(統編/身分證字號) + OrderNo + TotalPrice + 商家交易密碼 + TransStatus並使用sha-1雜湊函數取得組合字串的雜湊值附錄 | |
TotalPrice | 交易金額 | string | Y | 整數,30~999999999 | |
PayType | 付款方式 | string | 2 | Y | 10 : 超商代手條碼繳費 |
BarCode1 | 條碼1 | string | Y | Code39條碼文數字 | |
BarCode2 | 條碼2 | string | Y | Code39條碼文數字 | |
BarCode3 | 條碼3 | string | Y | Code39條碼文數字 | |
NewDate | 產生日期(繳款日) | string | Y | 超商條碼產生日期(繳款日)(格式:yyyy/mm/ddhh:mm:ss) | |
DueDate | 繳款期限 | string | Y | 超商條碼繳款期限 (yyyy/mm/dd) | |
TranStatus | 繳款狀態 | string | 1 | Y | 回傳S代表繳款成功;F代表未繳款 |
1.4 ibon/FamiPort 交易回傳
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
BuysafeNo | PayNow訂單編號 | string | Y | ||
OrderNo | 商家自訂編號 | string | Y | 不可為中文 | |
TotalPrice | 交易金額 | string | Y | 整數,30~999999999 | |
PayType | 付款方式 | string | 2 | Y | 05 : ibon/FamiPort |
IBONNO/FamiPortNo | Ibon/FamiPort繳費代碼 | string | Y | Ibon或FamiPort代碼 | |
NewDate | 產生日期(繳款日) | string | Y | Ibon/FamiPort代碼產生日期(繳款日)(格式:yyyy/mm/ddhh:mm:ss) | |
DueDate | 繳款期限 | string | Y | Ibon/FamiPort代碼繳款期限 (yyyy/mm/dd) | |
TranStatus | 繳款狀態 | string | 1 | Y | 回傳S代表繳款成功;F代表未繳款 |
PassCode | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo(統編/身分證字號) + OrderNo + TotalPrice + 商家交易密碼 + TransStatus並使用sha-1雜湊函數取得組合字串的雜湊值附錄,成功交易回傳時才加上TranStatus | |
PassCode2 | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : PassCode + ReceiverEmail二個參數值並使用sha-1雜湊函數取得組合字串的雜湊值附錄並轉換大寫且僅於成功交易回傳 | |
Note1 | 備註1 | string | Y | 商家自訂參數 | |
Note2 | 備註2 | string | Y | 商家自訂參數 |
一般票券交易串接-附錄
測試平台網址須知
說明
- 測試平台網址:
https://test.paynow.com.tw
各項服務所對應位置皆與正式平台相同 - 測試帳號:請至
https://test.paynow.com.tw
加入會員,登入帳號即為您的測試帳號 - 測試平台的任何交易除了虛擬帳號不可繳款外,其餘測試都是交易失敗的。
- 接收網頁請串接正確,才能接收失敗 訊息,測試平台與正式平台資料庫...等皆為完全獨立,故待所有程式串接測試完畢後,轉移至正式平台上線前,不可在正式平台進行測試交易,違者將會提出警告並停用賣家帳號,請務必回到
https://www.paynow.com.tw
申請正式會員 - 正式平台與測試平台環境皆相同,正式上線後,同樣需設定相關回傳網址。目前PayNow 開放的服務為信用卡交易、WebATM、虛擬帳號
- WebATM:若非約定帳戶,一日轉帳總金額不可超過3萬。故若您的交易金額大於2萬以上,建議使用信用卡,此付費方式就不會有交易金額的限制
- 退款須知:請慎用退款機制,避免連續退款、異常退款⋯等行為產生,此類行為將可能被銀行視為信用、異常交易問題,PayNow將會停止您的帳號服務
- 如需測試交易行為,請至測試平台,不可在正式平台進行測試退款交易,違者將會提出警告並停用賣家帳號**
預存授權
前言
有關網路商店購物車金流串接技術文件,共分一本串接技術文件,其中包含第一、二部份交易傳送及回傳
串接技術文件,主要在於說明各部份串接的用意與功能(此部分為網路商店購物車金流必要之串接作業)
當第一部份串接完成時,您的EC平台即可以開始接受線上交易包含信用卡
功能說明
- 即時交易傳送
- 信用卡、WbeAtm、虛擬帳號轉帳的交易及時傳送給PayNow平台
- 即時交易回傳
- PayNow平台接收到EC平台傳送之信用卡、WebATM交易後,將銀行回復結果即時回復給EC平台
訊息傳送介面、回傳
說明
- 使用者在此頁面選擇取貨門市,選擇完畢後回傳門市資訊至帶入的回傳網址
傳遞方式:Http POST method
Request
◎ 付款方式為信用卡、WebATM、虛擬帳號、超商代收
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
WebNo | 統編/身分證 | string | 10 | Y | 賣家登入帳號,如身分證開頭請為大寫傳送 |
PassCode | 傳遞碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo + OrderNo + TotalPrice + apicode並使用sha-1雜湊函數取得組合字串的雜湊值附錄 | |
ReceiverName | 消費者姓名 | string | 20 | Y | 不可為數字 |
ReceiverID | 消費者ID | string | 50 | Y | 消費者身分證/Email/手機號碼 |
ReceiverTel | 消費者電話 | string | 20 | Y | 若沒有手機可填入聯絡電話Ex:0225063733;0913123456 |
ReceiverEmail | 消費者Email | string | Y | 需符合Email規格 | |
OrderNo | 商家自訂訂單編號 | string | 50 | Y | 不可為中文 |
ECPlatform | EC平台提供商 | string | 100 | Y | 商家網站名稱(例 : XXX購物網、對外商店名稱) |
TotalPrice | 交易金額 | string | Y | 最低交易金額為新台幣$30元(票券交易請帶入可與票券數量整除的總金額) | |
OrderInfo | 商家自訂交易訊息 | string | 200 | Y | 交易內容商家可自訂(5~200字內) |
Note1 | 備註1 | string | 200 | Y | 商家自訂參數 |
Note2 | 備註2 | string | 200 | Y | 商家自訂參數 |
PayType | 付款方式 | string | 2 | Y | 01:信用卡 |
AtmRespost | 是否需要導頁回傳參數 | string | 1 | N | 0或1;賣家交易需回傳參數請帶入1否則請帶入0。(預設為0) |
DeadLine | 繳款期限 | string | 1 | N | 限數字,部分付款方式適用(ex:超商代收,虛擬帳號);預設為0 |
CIFID | UserID | string | 18 | Y | 預存授權使用者帳號 |
CIFPW | UserPW | string | 18 | Y | 預存授權使用者密碼 |
CIFID_SN | SN(序號) | string | 2 | 預存卡號流水號 | |
Installment | 預備繳款期數 | string | 1 | N | 限數字(預存時必須大於1,最大24) |
EPT | 系統分系代數 | string | 1 | Y | 固定帶1 |
※店配服務須向PayNow申請設定方可使用
Response
1.1 付款方式:信用卡
傳遞方式:Http POST method
參數回傳時會以 URL Encode 編碼,網頁字集為 UTF-8,請以 URL Decode 解碼
參數 | 名稱 | 型態 | 長度 | 必須 | 備註 |
---|---|---|---|---|---|
BuysafeNo | PayNow訂單編號 | string | 19 | Y | |
PassCode | 驗證碼 | string | Y | 以下參數值依序組合起來成一段字串(不包含+號) : WebNo + OrderNo + TotalPrice + 商家交易密碼 + TranStatus並使用sha-1雜湊函數取得組合字串的雜湊值附錄PS.請轉大寫 | |
OrderNo | 商家自訂編號 | string | 20 | Y | 不可為中文 |
TranStatus | 交易結果 | string | 1 | Y | 回傳S代表交易成功;F代表交易失敗 |
ErrDesc | 錯誤描述 | string | 200 | Y | 當TranStatus為F時,將回傳錯誤訊息(失敗原因)於此,TranStatus為S時則無此參數 |
TotalPrice | 交易金額 | string | Y | 整數,30~999999999 | |
Note1 | 備註1 | string | 200 | Y | 商家自訂參數 |
Note2 | 備註2 | string | 200 | Y | 商家自訂參數 |
PayType | 付款方式 | string | 2 | Y | 13: 預存授權 |
Installment | 預備繳款期數 | string | 2 | Y | 限數字(1~36) |
PayDay | 授權日 | string | 2 | Y | 預存授權日期 |
CIFID | UserID | string | 18 | Y | 預存授權使用者帳號 |
CIFPW | UserPW | string | 18 | Y | 預存授權使用者密碼 |
CIFID_SN | SN(序號) | string | 2 | 預存卡號流水號 |
※ 重要訊息:若對應的付款方式回傳值中有其他參數值存在時,可不必理會
預存授權-附錄
測試平台網址須知
說明
- 測試平台網址:
https://test.paynow.com.tw
各項服務所對應位置皆與正式平台相同 - 測試帳號:請至
https://test.paynow.com.tw
加入會員,登入帳號即為您的測試帳號 - 測試平台的任何交易測試都是交易失敗的。
- 接收網頁請串接正確,才能接收失敗訊息,測試平台與正式平台資料庫...等皆為完全獨立,故待所有程式串接測試完畢後,轉移至正式平台上線前,不可在正式平台進行測試交易,違者將會提出警告並停用賣家帳號,請務必回到
https://www.paynow.com.tw
申請正式會員 - 正式平台與測試平台環境皆相同,正式上線後,同樣需設定相關回傳網址。目前PayNow 開放的服務為信用卡交易、WebATM、虛擬帳號
- 退款須知:請慎用退款機制,避免連續退款、異常退款⋯等行為產生,此類行為將可能被銀行視為信用、異常交易問題,PayNow將會停止您的帳號服務
- 如需測試交易行為,請至測試平台,不可在正式平台進行測試退款交易,違者將會提出警告並停用賣家帳號**