模擬串接服務 - 後付款請款

經銷商『後付款請款』請求欄位
Id Name Description Type Additional Information
1 agent_uid 經銷商商務代號
string 必填
2 service 服務名稱
string 必填
{ "service_name": "api", "cmd": "api\/afpshipment" }
JSON格式,AES256加密資料
3 encry_data 『後付款請款』欄位資料 string 必填
『後付款請款』欄位參考
JSON格式,AES256加密資料
特約商店『後付款請款』請求欄位
Id Name Description Type Additional Information
1 store_uid 特約商店商務代號
string 必填
2 service 服務名稱
string 必填
{ "service_name": "api", "cmd": "api\/afpshipment" }
JSON格式,AES256加密資料
3 encry_data 『後付款請款』欄位資料 string 必填
『後付款請款』欄位參考
JSON格式,AES256加密資料
後付款請款』欄位
Id Name Description Type Additional Information
1 store_uid 特約商店代碼 string
2 key 特約商店驗證碼 string
3 uid 訂單編號(UID) string
4 shipment_no 出貨編號 string
5 delivery_code 貨運商家編號 integer 『貨運商家編號』值參考
後付款請款』回傳欄位
Id Name Description Type Additional Information
1 code 交易狀態代碼 string
2 msg 回傳訊息 string
3 uid Payment Hub之交易流水號 string
4 key 交易驗証碼 string
5 finishtime 交易完成時間(YYYYMMDDHHmmss) string
6 cardno 銀行端口回傳碼 string
7 acode 授權碼 string
8 card_type 信用卡卡別 integer 『信用卡別類型』值參考
9 issuing_bank 發卡行 string
10 issuing_bank_uid 發卡銀行代碼 string
11 is_agent_charge 是否為經銷商代收費模式 int 『是否為經銷商代收費模式』值參考
12 transaction_mode 交易服務類型 integer 『交易服務類型』值參考
13 supplier_name 交易之金融服務商 string
14 supplier_code 交易之金融服務商代碼 string
15 order_id 貴特店系統的訂單編號 string
16 user_id 消費者帳號 string
17 cost 總交易金額 string
18 currency 原交易幣別 string
19 actual_cost 實際交易金額 string
20 actual_currency 實際交易幣別 string
21 pfn 付費方法 string 『回傳付款方式』值參考
22 actual_pay_mode 實際支付方式
(當pfn為CASH-自行收款時,告知系統實際收款方式)
string 『自行收款付款方式』值參考
23 trans_type 交易類型 integer 『交易類型定義』值參考
24 result_type 回傳結果資料類型 string 『閘道內容回傳格式類型』值參考
25 result_content_type 回傳資料內容類型 string 『資料內容所屬支付名稱』值參考
26 result_content 回傳結果 string 『後付款請款交易回傳欄位』值參考
27 echo_0 自訂回傳參數 1 string
28 echo_1 自訂回傳參數 2 string
29 echo_2 自訂回傳參數 3 string
30 echo_3 自訂回傳參數 4 string
31 echo_4 自訂回傳參數 5 string
貨運商家編號』 值內容
Value Description Type Additional Information
0 無法辨識 integer
1 黑貓宅急便 integer
2 台灣宅配通 integer
3 新竹貨運 integer
4 大榮貨運 integer
5 中華郵政 integer
6 便利帶 integer
7 大智通物流 integer
8 日翊文化行銷 integer
9 EMS integer
10 國際e郵包 integer
11 大和國際宅急便 integer
12 佐川國際宅急便 integer
13 Dmail/Pmail integer
14 ECMS日本 integer
信用卡別類型』 值內容
Value Description Type Additional Information
0 無法辨識或支付方式為非信用卡類 string
1 VISA string
2 MasterCard string
3 JCB string
4 AMEX string
是否為經銷商代收費模式』 值內容
Value Description Type Additional Information
1 是經銷商代收費模式 integer
0 不是經銷商代收費模式 integer
交易服務類型』 值內容
Value Description Type Additional Information
0 尚未進行閘道交易 integer
1 代收代付 integer
2 特店模式 integer
回傳付款方式』 值內容
Value Description Type Additional Information
CREDITCARD 信用卡 string
CSTORECODE 超商代碼 string
WEBATM WEBATM string
E_COLLECTION 虛擬帳號 string
ABROAD 海外信用卡 string
ALIPAY 支付寶 string
WECHAT 微信支付 string
LINEPAYON LINE Pay線上付款 string
LINEPAYOFF LINE Pay線下付款 string
WECHATOFF 微信支付線下 string
APPLEPAY APPLE PAY string
GOOGLEPAY Google Pay string
CARDLESS 無卡分期 string
PION Pi 拍錢包線上 string
PIOFF Pi 拍錢包線下 string
AMEX 美國運通 string
JKOON 街口支付線上 string
JKOOFF 街口支付線下 string
ALIPAYOFF 支付寶線下 string
EASYWALLETON 悠遊付線上 string
EASYWALLETOFF 悠遊付線下 string
TWPAYOFF 台灣Pay線下 string
PXPAYOFF 全支付線下 string
AFP 後付款 string
EACH eACH交易 string
BARCODE 超商繳費代碼 string
EASYCARD 悠遊卡 string
IPASS 一卡通 string
ICASH iCash string
自行收款付款方式』 值內容
Value Description Type Additional Information
REMITTENCE 轉帳匯款 string
CASH 現金交易 string
ZINGALAPAY 銀角零卡 string
LINEPAY LINE Pay string
JKO 街口支付 string
PI Pi 拍錢包 string
EASYWALLET 悠遊付 string
PXPAY 全支付 string
PLUSPAY 全盈支付 string
ALIPAY 支付寶 string
WECHAT 微信支付 string
MOMO Momo收款 string
SHOPEE 蝦皮拍賣收款 string
ETMALL 東森收款 string
PCSTORE PChome商店街收款 string
PCHOME24H PChome24H收款 string
RUTEN 露天拍賣收款 string
SHOPLINE Shop line收款 string
FOODPANDA 熊貓收款 string
UBEREATS Uber eats收款 string
CYBERBIZ Cyberbiz收款 string
YAHOOBID YAHOO拍賣收款 string
RAKUTEN 樂天市場收款 string
CAROUSELL 旋轉拍賣收款 string
FACEBOOKGROUPS FB社團收款 string
PINKOI Pinkoi收款 string
91APP 91APP收款 string
COD_MYPAY MYPAY物流代收 string
COD_HCT 新竹物流代收 string
COD_TCAT 黑貓宅急便代收 string
COD_MYSHIP711 7-ELEVEN賣貨便代收 string
COD_FAMISTORE 好賣+代收 string
COD_HISHIPBUYER 萊賣貨代收 string
COD_KERRYTJ 嘉里大榮代收 string
CSTORECODE_IBON 超商代碼(IBON) string
CSTORECODE_FAMIPORT 超商代碼(FamiPort) string
CSTORECODE_LIFEET 超商代碼(Life-ET) string
CSTORECODE_OKGO 超商代碼(OK GO) string
ETICKET_EASYCARD 悠遊卡 string
ETICKET_IPASS 一卡通 string
ETICKET_ICASH iCash string
CRYPTO_BTC 比特幣 string
CRYPTO_ETH 乙太幣 string
TELECOM_CHT 中華電信代收 string
TELECOM_FET 遠傳電信代收 string
TELECOM_TWM 台灣大哥大代收 string
TELECOM_TSTAR 台灣之星代收 string
TELECOM_APT 亞太電信代收 string
ECPAY_CREDIT 綠界收款(信用卡) string
ECPAY_WEBATM 綠界收款(網路ATM) string
ECPAY_ATM 綠界收款(自動櫃員機) string
ECPAY_CVS 綠界收款(超商代碼) string
ECPAY_BARCODE 綠界收款(超商條碼) string
ECPAY_TWQR 綠界收款(行動支付) string
NEWEBPAY_CREDIT 藍新收款(信用卡付款) string
NEWEBPAY_VACC 藍新收款(銀行 ATM 轉帳付款) string
NEWEBPAY_WEBATM 藍新收款(網路銀行轉帳付款) string
NEWEBPAY_BARCODE 藍新收款(超商條碼繳費) string
NEWEBPAY_CVS 藍新收款(超商代碼繳費) string
NEWEBPAY_LINEPAY 藍新收款(LINE Pay 付款) string
NEWEBPAY_ESUNWALLET 藍新收款(玉山 Wallet) string
NEWEBPAY_TAIWANPAY 藍新收款(台灣 Pay) string
NEWEBPAY_CVSCOM 藍新收款(超商取貨付款) string
CREDITCARD_TCB 信用卡(合庫銀行) string
CREDITCARD_ESUNBANK 信用卡(玉山銀行) string
CREDITCARD_FIRSTBANK 信用卡(第一銀行) string
CREDITCARD_FUBONBANK 信用卡(台北富邦銀行) string
CREDITCARD_TSIB 信用卡(台新銀行) string
CREDITCARD_NCCC 信用卡(聯信) string
CREDITCARD_CTBC 信用卡(中信銀行) string
CREDITCARD_KGIBANK 信用卡(凱基銀行) string
CREDITCARD_YUANTABANK 信用卡(元大銀行) string
CREDITCARD_CUB 信用卡(國泰世華銀行) string
CREDITCARD_BANKSINOPAC 信用卡(永豐銀行) string
CREDITCARD_MEGABANK 信用卡(兆豐銀行) string
CREDITCARD_GLOBALPAYMENTS 信用卡(環匯亞太) string
AMEX_TSIB 美國運通(台新銀行) string
AMEX_CTBC 美國運通(中信銀行) string
AMEX_NCCC 美國運通(聯信) string
UNIONPAY_TCB 銀聯卡(合庫銀行) string
UNIONPAY_ESUNBANK 銀聯卡(玉山銀行) string
UNIONPAY_NCCC 銀聯卡(聯信) string
UNIONPAY_TSIB 銀聯卡(台新銀行) string
UNIONPAY_KGIBANK 銀聯卡(凱基銀行) string
UNIONPAY_YUANTABANK 銀聯卡(元大銀行) string
UNIONPAY_BANKSINOPAC 銀聯卡(永豐銀行) string
UNIONPAY_CUB 銀聯卡(國泰世華銀行) string
BARCODE_SKBANK 超商繳費條碼(新光銀行) string
BARCODE_ESUNBANK 超商繳費條碼(玉山銀行) string
BARCODE_CTBC 超商繳費條碼(中信銀行) string
TWPAY_BOT 台灣Pay(台灣銀行) string
TWPAY_LANDBANK 台灣Pay(台灣土地銀行) string
TWPAY_TCB 台灣Pay(合庫銀行) string
TWPAY_FIRSTBANK 台灣Pay(第一銀行) string
TWPAY_HNCB 台灣Pay(華南銀行) string
TWPAY_CHB 台灣Pay(彰化銀行) string
TWPAY_SCSB 台灣Pay(上海商銀) string
TWPAY_CUB 台灣Pay(國泰世華銀行) string
TWPAY_MEGABANK 台灣Pay(兆豐銀行) string
TWPAY_BOK 台灣Pay(高雄銀行) string
TWPAY_TBB 台灣Pay(台灣企銀) string
TWPAY_KTB 台灣Pay(京城銀行) string
TWPAY_HWATAIBANK 台灣Pay(華泰銀行) string
TWPAY_SUNNYBANK 台灣Pay(陽信銀行) string
TWPAY_KSCC 台灣Pay(基隆二信) string
TWPAY_TFCCBANK 台灣Pay(淡水一信) string
TWPAY_HCFCBANK 台灣Pay(新竹一信) string
TWPAY_TSCA 台灣Pay(台中二信) string
TWPAY_CH6C 台灣Pay(彰化六信) string
TWPAY_HL2C 台灣Pay(花蓮二信) string
TWPAY_ESUNBANK 台灣Pay(玉山銀行) string
TWPAY_TSIB 台灣Pay(台新銀行) string
TWPAY_AFISC 台灣Pay(農金資) string
TWPAY_YUANTABANK 台灣Pay(元大銀行) string
TWPAY_CTBC 台灣Pay(中信銀行) string
TWPAY_FAST 台灣Pay(南農中心) string
TWPAY_SCU 台灣Pay(南資中心) string
交易類型定義』 值內容
Value Description Type Additional Information
1 一般 (預設) integer
2 分期 integer
3 紅利 integer
閘道內容回傳格式類型』 值內容
Value Description Type Additional Information
0 無法辨識 integer
1 網址 integer
2 超連結本文 integer
3 xml integer
4 json integer
5 csv integer
6 串流 integer
資料內容所屬支付名稱』 值內容
Value Description Type Additional Information
E_COLLECTION 虛擬帳號 string
IBON iBON string
FAMIPORT FamiPort string
LIFEET LIFE-ET string
WEBATM WEBATM string
CREDITCARD 信用卡 string
UNIONPAY 銀聯卡 string
SVC 點數卡(GASH ,Imoney) string
ABROAD 海外信用卡 string
ALIPAY 支付寶 string
WECHAT 微信支付 string
LINEPAYON LINE Pay線上付款 string
LINEPAYOFF LINE Pay線下付款 string
WECHATOFF 微信支付線下 string
APPLEPAY APPLE PAY string
GOOGLEPAY Google Pay string
EACH eACH交易 string
CARDLESS 無卡分期 string
PION Pi 拍錢包線上 string
PIOFF Pi 拍錢包線下 string
AMEX 美國運通 string
JKOON 街口支付線上 string
JKOOFF 街口支付線下 string
ALIPAYOFF 支付寶線下 string
EASYWALLETON 悠遊付線上 string
EASYWALLETOFF 悠遊付線下 string
TWPAYOFF 台灣Pay線下 string
PXPAYOFF 全支付線下 string
AFP 後付款 string
BARCODE 超商條碼繳費 string
後付款請款交易回傳欄位』欄位
Id Name Description Type Additional Information
1 OrderTotalCost 出貨交易金額 string
2 TradeNo 後付款交易單號 string
3 TradeDate 出貨交易發動時間,格式YYYYMMDDHHmmss string
AES256資料加密方式說明

1、所有的API送出HTTPs請求之欄位中,service 和 encry_data 欄位皆進行 AES256+BASE64 加密處理。
2、AES加密,格式為CBC,長度為256bits,金鑰長度32,IV長度16,傳遞內文為加密後組合IV並經過Base64轉換後傳出。

方式:
使用自訂的AES256函式將JSON資料加密後,再將IV資料和此AES256加密後的JSON資料串聯後,使用base64再進行加密成ASCII字串即可完成加密。

    PHP加密示意:
    AesEncrypt -> base64_ecode($IV . $JSON)

    C#加密示意:
    AesEncrypt -> (bytes)IV+(bytes)Json -> toBase64

    Java加密示意:
    AesEncrypt -> (bytes)IV+(bytes)Json -> toBase64

    Node.js加密示意:
    AesEncrypt -> concat([IV,JSON], [IV_SIZE,JSON_SIZE]) -> toString('base64')
    Python加密示意:
    AesEncrypt -> (bytes)IV+(bytes)Json -> base64.b64encode

範例程式碼