應用場景
使用者在特店(賣家會員)消費後，選擇便利商店取貨時，特店將透過此API連結至各超商電子地圖系統，提供使用者選擇取貨門市，選取完畢會將門市資訊回傳至指定位置(ServerReplyURL)
API介接網址
- 測試環境：https://logistics-stage.ecpay.com.tw/Express/map
- 正式環境：https://logistics.ecpay.com.tw/Express/map
HTTPS傳輸協定
- HTTP Method：POST
- Accept：text/html
- Content Type：application/x-www-form-urlencoded
特店Request參數說明
MerchantID String(10)
廠商編號 必填
由綠界科技提供
MerchantTradeNo String(20)
廠商交易編號
- 廠商交易編號均為唯一值，不可重複使用。
- 英數字大小寫混合。
LogisticsType String(20)
物流類型 必填
CVS:超商取貨
LogisticsSubType String(20)
物流子類型 必填
當物流類型為CVS時，子物流類型選擇以下類型：
- B2C
FAMI：全家
UNIMART：7-ELEVEN超商
UNIMARTFREEZE：7-ELEVEN冷凍店取
HILIFE：萊爾富 - C2C
FAMIC2C：全家店到店
UNIMARTC2C：7-ELEVEN超商交貨便
HILIFEC2C：萊爾富店到店
OKMARTC2C：OK超商店到店
注意事項：
- 若申請類型為B2C，只能串參數為FAMI、UNIMART、UNIMARTFREEZE、HILIFE；
- 若申請類型為C2C，只能串參數為FAMIC2C、UNIMARTC2C、HILIFEC2C、OKMARTC2C。
IsCollection String(1)
是否代收貨款 必填
- N：不代收貨款
- Y：代收貨款
ServerReplyURL String(200)
Server端回覆網址 必填
取得超商店鋪代號等資訊後，會回傳到此網址
ExtraData String(20)
額外資訊
供廠商傳遞保留的資訊，在回傳參數中，會原值回傳
Device Int
使用設備
根據Device類型，來顯示相對應之電子地圖
- 0：PC（預設值）
- 1：Mobile
注意事項：
- 7-ELEVEN：此參數如有帶值，將以帶入的值為主；若無則以系統判斷之裝置參數為主。
- 全家超商電子地圖已整合PC與Mobile，此參數將不影響顯示結果。
綠界Response參數說明
MerchantID String(10)
廠商編號
MerchantTradeNo String(20)
廠商交易編號
LogisticsSubType String(20)
物流子類型
CVSStoreID String(9)
使用者選擇的超商店舖編號
CVSStoreName String(10)
使用者選擇的超商店舖名稱
CVSAddress String(60)
使用者選擇的超商店舖地址
CVSTelephone String(20)
使用者選擇的超商店舖電話
注意事項：
下列物流子類型不會回傳此欄位資訊：
- UNIMART：7-ELEVEN超商
- UNIMARTC2C：7-ELEVEN超商交貨便
CVSOutSide String(1)
使用者選擇的超商店舖是否為離島店鋪
- 0：本島
- 1：離島
注意事項：
僅下列物流子類型會回傳此欄位：
- UNIMART：7-ELEVEN超商
- UNIMARTC2C：7-ELEVEN超商交貨便
ExtraData String(20)
額外資訊
原資料回傳