模擬串接服務 - 掃碼交易-微信線上

特約商店『掃碼交易-微信線上』請求欄位
Id Name Description Type Additional Information
1 store_uid 特約商店商務代號
string 必填
2 service 服務名稱
string 必填
{ "service_name": "api", "cmd": "api\/postransaction" }
JSON格式,AES256加密資料
3 encry_data 『掃碼交易-微信線上』欄位資料 string 必填
『掃碼交易-微信線上』欄位參考
JSON格式,AES256加密資料
掃碼交易-微信線上』欄位
Id Name Description Type Additional Information
1 store_uid 特約商店代碼 string 必填
2 cost 訂單總金額 string 必填
3 currency 預設交易幣別(預設為TWD新台幣) string
4 order_id 訂單編號 string 必填
5 items 訂單內物品數 array 每筆『商品項目』欄位參考
6 echo_0 自訂回傳參數 1 string
7 echo_1 自訂回傳參數 2 string
8 echo_2 自訂回傳參數 3 string
9 echo_3 自訂回傳參數 4 string
10 echo_4 自訂回傳參數 5 string
11 pfn 支付方式支援的方式有
CREDITCARD(信用卡)
OFFLINE(線下交易)
LINEPAYON(LINEPay線上)
PION(Pi錢包線上)
WECHAT(微信線上)
ALIPAY(支付寶線上)
JKOON(街口支付線上)
EASYWALLETON(悠遊付線上)
PXPAYON(全支付線上)
PLUSPAYON(全盈支付線上)
CASH(自行收款)
string
12 discount 折價金額 (預設0) string
13 shipping_fee 運費 string
14 user_id 消費者帳號 string
15 user_name 消費者姓名 string
16 user_real_name 消費者真實姓名 string
17 user_english_name 消費者英文名稱 string
18 user_zipcode 消費者郵遞區號 string
19 user_address 消費者地址 string
20 user_sn_type 證號類型 string 『證號類型』值參考
21 user_sn 付款人身分證/統一證號/護照號碼 string
22 user_phone 消費者家用電話 string
23 user_cellphone_code 消費者行動電話國碼 string
24 user_cellphone 消費者行動電話 string
25 user_email 消費者 E-Mail string
26 user_birthday 消費者生日 string
27 ip 消費者來源 IP string
28 issue_invoice_state 開立發票 integer 『電子發票是否開立狀態』值參考
29 invoice_ratetype 電子發票稅率別 integer 『電子發票稅率別』值參考
30 invoice_tax_rate 電子發票稅率:預設0.05(零稅與免稅帶0) float
31 invoice_remark 發票註記(依加值中心提供註記功能) string
32 invoice_input_type 電子發票開立類型 integer 『電子發票開立類型』值參考
33 invoice_cloud_type 「雲端發票」類型 integer 當invoice_input_type為1,此狀態才有效
『雲端發票類型』值參考
34 invoice_tax_id 統一編號 string 當invoice_input_type為1,此欄位才有效,非必要
35 invoice_mobile_code 手機條碼 string 當invoice_cloud_type為2,此欄位才有效
36 invoice_natural_person 自然人憑證條碼 string 當invoice_cloud_type為3,此欄位才有效
37 invoice_m_post_zone EMail 紙本寄送郵遞區號 string 當invoice_cloud_type為4,此欄位才有效,非必須
38 invoice_m_address EMail 紙本寄送住址 string 當invoice_cloud_type為4,此欄位才有效,非必須
39 invoice_love_code 愛心碼 string 當invoice_input_type為2,此欄位才有效
40 invoice_b2b_title 發票抬頭 string 當invoice_input_type為3時,此欄位才有效
41 invoice_b2b_id 統一編號 string 當invoice_input_type為3時,此欄位才有效
42 invoice_b2b_post_zone 發票郵遞區號 string 當invoice_input_type為3時,此欄位才有效,非必須
43 invoice_b2b_address 發票地址 string 當invoice_input_type為3時,此欄位才有效
44 interface 消費者操作介面類型 pc/app string
45 data_json 聚合線下掃碼資訊,JSON字串格式
若pfn=OFFLINE此欄位才有效
特約商店如果自行掃碼,可直接帶入此欄位資訊,若透過刷卡機則可忽略帶此欄位
string 非必填
『錢包被掃交易資料』值參考
46 device_name 設備編號 string
47 invoice_print_type 發票列印類型(預設只印電子發票) integer 『電子發票列印類型』值參考
48 actual_pay_mode 實際支付方式
(當pfn為CASH-自行收款時,告知系統實際收款方式)
string 『自行收款付款方式』值參考
掃碼交易-微信線上』回傳欄位
Id Name Description Type Additional Information
1 code 回傳碼 string
2 msg 回傳訊息 string
商品項目』欄位
Id Name Description Type Additional Information
1 id 商品編號 string 必填
2 name 商品名稱 string 必填
3 cost 商品單價 integer 必填
4 amount 商品數量 integer 必填
5 total 商品小計 integer 必填
6 image_url 商品圖片連結(僅LINEPay線上使用) string
證號類型』 值內容
Value Description Type Additional Information
1 身份證字號(預設) integer
2 統一證號 integer
3 護照號碼 integer
電子發票是否開立狀態』 值內容
Value Description Type Additional Information
0 不開立電子發票 integer
1 開立電子發票 integer
2 依系統設定(預設) integer
電子發票稅率別』 值內容
Value Description Type Additional Information
1 應稅(預設) integer
2 零稅率 integer
3 免稅 integer
電子發票開立類型』 值內容
Value Description Type Additional Information
0 未使用電子發票開立 integer
1 雲端發票 integer
2 發票捐贈 integer
3 實體發票 integer
雲端發票類型』 值內容
Value Description Type Additional Information
0 未使用雲端發票類型 integer
2 手機條碼 integer
3 自然人憑證條碼 integer
4 以E-Mail寄送 integer
錢包被掃交易資料』欄位
Id Name Description Type Additional Information
1 qrCode qrcode 交易碼 string 必填
電子發票列印類型』 值內容
Value Description Type Additional Information
0 不列印 自行處置 integer
1 列印 電子發票 + 商品明細 integer
2 只印電子發票 integer
3 只印商品明細 integer
自行收款付款方式』 值內容
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_YUANTABANK 支付寶元大 string
ALIPAY_MEGABANK 支付寶兆豐 string
ALIPAY_TCB 支付寶合庫 string
WECHAT_SKBANK 微信支付新光 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
ECPAY_IN_STORE_PICKUP 綠界收款(超取) 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
DS_SHINSHIN 欣欣大眾 string
DS_MINGYAO 明曜百貨 string
DS_DAYEH 大葉高島屋 string
DS_CHUNGYO 中友百貨 string
DS_KSSOGO 廣三SOGO百貨 string
DS_FOCUSQUARE Focus時尚流行館 string
DS_NICEPLAZA 耐斯廣場 string
DS_DREAMMALL 夢時代購物中心 string
DS_UNIUSTYLE 統一時代百貨 string
DS_PARKLANES 金典綠園道商場 string
DS_CITYPLAZA 大都會廣場 string
DS_LIHPAOMALL 麗寶百貨廣場 string
DS_EDORAPARK 瀚星百貨 string
DS_BEYONDPLAZA 比漾廣場 string
DS_HAYASHI 林百貨 string
DS_SHINESQUARE 昕境廣場 string
DS_LANDMARKLIFEPLAZA 置地生活廣場 string
DS_TONLIN 統領廣場 string
DS_HONHUI 宏匯廣場 string
DS_TSRD 南紡購物中心 string
DS_FEDS_XINYIA13 遠東百貨-遠百信義 A13 string
DS_FEDS_BANQIAO 遠東百貨-板橋中山店 string
DS_FEDS_TAOYUAN 遠東百貨-桃園店 string
DS_FEDS_ZHUPEI 遠東百貨-竹北店 string
DS_FEDS_CHIAYI 遠東百貨-嘉義店 string
DS_FEDS_HUALIEN 遠東百貨-花蓮店 string
DS_FEDS_MEGACITY_BANQIAO 遠東百貨-MegaCity板橋大遠百 string
DS_FEDS_HSINCHU 遠東百貨-新竹大遠百 string
DS_FEDS_TOPCITY_TAICHUNG 遠東百貨-Top City台中大遠百 string
DS_FEDS_TAINAN_GONGYUAN 遠東百貨-台南大遠百公園店 string
DS_FEDS_TAINAN_CHENGKUNG 遠東百貨-台南大遠百成功店 string
DS_FEDS_KAOHSIUNG 遠東百貨-高雄大遠百 string
DS_SKM_XINYI 新光三越-台北信義新天地 string
DS_SKM_TAIPEI_STATION 新光三越-台北站前店 string
DS_SKM_TAIPEI_NANJING_W 新光三越-台北南西店 string
DS_SKM_TAIPEI_TIANMU 新光三越-台北天母店 string
DS_SKM_TAOYUAN_STATION 新光三越-桃園站前店 string
DS_SKM_TAICHUNG_PORT 新光三越-台中中港店 string
DS_SKM_CHIAYI_CHUIYANG 新光三越-嘉義垂楊店 string
DS_SKM_TAINAN_ZHONGSHAN 新光三越-台南中山店 string
DS_SKM_TAINAN_XIMEN 新光三越-台南西門店 string
DS_SKM_KAOHSIUNG_SANDUO 新光三越-高雄三多店 string
DS_SKM_KAOHSIUNG_ZUOYING 新光三越-高雄左營店 string
DS_SKM_PARK 新光三越-SKM Park Outlets 高雄草衙 string
DS_SOGO_TAIPEI_ZHONGXIAO 遠東SOGO百貨-台北忠孝館 string
DS_SOGO_TAIPEI_FUXING 遠東SOGO百貨-台北復興館 string
DS_SOGO_TAIPEI_DUNHUA 遠東SOGO百貨-台北敦化館 string
DS_SOGO_TIANMU 遠東SOGO百貨-天母店 string
DS_SOGO_ZHONGLI 遠東SOGO百貨-中壢店 string
DS_SOGO_HSINCHU 遠東SOGO百貨-新竹店 string
DS_SOGO_KAOHSIUNG 遠東SOGO百貨-高雄店 string
DS_PACIFIC_FENGYUAN 太平洋百貨-豐原 string
DS_PACIFIC_PINGTUNG 太平洋百貨-屏東 string
DS_PACIFIC_SUNNYPARK 太平洋百貨-Sunny Park日光廣場 string
DS_PACIFIC_PINGTUNG_GONGYONG 太平洋百貨-屏東驛站商場 string
DS_PACIFIC_PINGTUNG_GUANGFU 太平洋百貨-屏東轉運站商場 string
DS_PACIFIC_CHAOZHOU 太平洋百貨-潮州驛站商場 string
DS_HANSHIN_KAOHSIUNG 漢神百貨 string
DS_HANSHIN_ARENA 漢神巨蛋購物廣場 string
DS_BREEZE_CENTER 微風廣場 string
DS_BREEZE_TAIPEISTATION 微風台北車站 string
DS_BREEZE_NTUHOSPITAL 微風台大醫院商場 string
DS_BREEZE_NANJING 微風南京 string
DS_BREEZE_XINYI 微風信義 string
DS_BREEZE_SONGGAO 微風松高 string
DS_BREEZE_NANSHAN 微風南山 string
DS_BREEZE_TSGHOSPITAL 微風三總商店街 string
DS_BREEZE_ACADEMIASINICA 微風中央研究院 string
DS_GM_ZHONGHE GlobalMall-新北中和 string
DS_GM_BANQIAO GlobalMall-環球板橋車站 string
DS_GM_A8 GlobalMall-環球桃園A8 string
DS_GM_A19 GlobalMall-環球桃園A19 string
DS_GM_A9 GlobalMall-環球林口A9 string
DS_GM_NANGANG GlobalMall-環球南港車站 string
DS_GM_XINZUOYING GlobalMall-環球新左營車站 string
DS_GM_PINGTUNG GlobalMall-環球屏東市 string
DS_TRK_MALL 大魯閣新時代購物中心 string
DS_TRK_SQUARE 大魯閣湳雅廣場 string
DS_TALEE_WUFU 大立大統五福店 string
DS_TALEE_A 大立百貨A館 string
DS_TALEE_B 大立百貨B館 string
DS_MITSUI_OUTLET_TAICHUNGPORT MITSUI OUTLET PARK 台中港 string
DS_MITSUI_OUTLET_TAINAN MITSUI OUTLET PARK 台南 string
DS_MITSUI_OUTLET_LINKOU MITSUI OUTLET PARK 林口 string
DS_MITSUI_LALAPORT_TAICHUNG Mitsui Shopping Park LaLaport 台中 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

範例程式碼