Id | Name | Description | Type | Additional Information |
---|---|---|---|---|
1 | store_uid | 特約商店商務代號 |
string | 必填 |
2 | service | 服務名稱 |
string | 必填
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 |
1、所有的API送出HTTPs請求之欄位中,service 和 encry_data 欄位皆進行 AES256+BASE64 加密處理。
2、AES加密,格式為CBC,長度為256bits,金鑰長度32,IV長度16,傳遞內文為加密後組合IV並經過Base64轉換後傳出。
方式:
使用自訂的AES256函式將JSON資料加密後,再將IV資料和此AES256加密後的JSON資料串聯後,使用base64再進行加密成ASCII字串即可完成加密。