應用場景
※此規格目前尚未開放
當消費者於特店（賣家會員）完成購物後，若因商品退貨需求需將商品寄回，特店（賣家會員）可將退貨相關資訊 POST 至綠界科技，建立逆物流訂單，供消費者將商品寄回特店（賣家會員），以完成退貨流程。
注意事項：
- 選擇地圖與門市建立訂單間隔時間太長，需留意門市關轉導致無法建立訂單。
- 測試環境請使用以下門市進行測試：
- 7-ELEVEN 超商：131386
- 訂單產生成功後，請確認ServerReplyURL是否收到成功的物流狀態，確保後續能持續收到物流狀態通知。
- 如帳戶餘額過低，將無法建立物流單，建議留存一定金額於綠界帳戶或至廠商後台預存綠界帳戶餘額供物流費扣款使用。
API介接網址
- 測試環境：https://logistics-stage.ecpay.com.tw/Express/ReturnUniMartC2C
- 正式環境：https://logistics.ecpay.com.tw/Express/ReturnUniMartC2C
HTTPS傳輸協定
- Accept：text/html
- Content Type：application/x-www-form-urlencoded
- HTTP Method：POST
特店Request參數說明
MerchantID String(10)
廠商編號 必填
由綠界科技提供
MerchantTradeNo String(20)
廠商交易編號
- 支援中文、數字、英文大小寫
- 廠商交易編號均為唯一值，不可重複使用
- 廠商交易編號可為空，系統會自動產生一組廠商訂單編號。
MerchantTradeDate String(20)
廠商交易時間 必填
請依消費者退貨的當下時間設定
(此時間不會等於綠界建立逆物流訂單完成的時間)
格式為：yyyy/MM/dd HH:mm:ss
GoodsAmount Int
商品金額 必填
- 商品金額範圍為1~20000元。
- 訂單的商品金額如果超出範圍，會訂單失敗且回傳錯誤代碼10500040商品金額有誤
GoodsName String(50)
商品名稱 必填
注意事項：
- 不得輸入^ ‘ ` ! @ # % & * + \ ” < >| _ [ ]等特殊符號
- 優先檢核是否有特殊字元，再檢核是有超過長度限制
- 長度限制檢核規則 :
中文佔2字元、全形佔2字元、其餘佔1字元
SenderName String(10)
退貨寄件人(買家)姓名 必填
發起退貨並將商品寄回的原購買者姓名
注意事項：
- 字元限制為4~10個字元(例：半形英文可支援4~10個字，中文可支援2~5個字)
- 不可帶入不符合姓名規則的文字如表情圖示(emoji符號)
注意事項：不可帶入數字和特殊符號(禁用特殊符號如下所示)
SenderPhone String(20)
退貨寄件人(買家)電話
發起退貨並將商品寄回的原購買者電話
SenderCellPhone String(10)
退貨寄件人(買家)手機 必填
發起退貨並將商品寄回的原購買者手機號碼
注意事項：
- 只允許數字、長度限制10碼、必須以09開頭
ReceiverName String(10)
退貨收件人(賣家)姓名 必填
接收退貨商品的原銷售者姓名
注意事項：
- 字元限制為4~10個字元(例：半形英文可支援4~10個字，中文可支援2~5個字)
- 不可帶入不符合姓名規則的文字如表情圖示(emoji符號)
注意事項：不可帶入數字和特殊符號(禁用特殊符號如下所示)
ReceiverPhone String(20)
退貨收件人(賣家)電話
接收退貨商品的原銷售者電話
注意事項：允許數字+特殊符號；特殊符號僅限()-#
ReceiverCellPhone String(10)
退貨收件人(賣家)手機 必填
接收退貨商品的原銷售者手機
注意事項：只允許數字、長度限制10碼、必須以09開頭
ReceiverEmail String(50)
退貨收件人(賣家)email
接收退貨商品的原銷售者email
ReceiverStoreID String(6)
退貨收件人(賣家)收件門市代號 必填
接收退貨商品的原銷售者收件門市
TradeDesc String(200)
交易描述
ServerReplyURL String(200)
Server端回覆網址 必填
逆物流狀態都會透過此URL通知
Remark String(200)
備註
PlatformID String(10)
特約合作平台商代號
- 由綠界科技提供，此參數為專案合作的平台商使用，一般廠商介接請放空值。
- 若為專案合作的平台商使用時，請帶賣家所綁定的MerchantID。
CheckMacValue String
檢查碼 必填
請參考附錄檢查碼機制
綠界Response參數說明
MerchantID String(10)
廠商編號
MerchantTradeNo String(20)
廠商交易編號
訂單產生時傳送給綠界科技的廠商交易編號
RtnCode Int
目前物流狀態
請參考物流狀態代碼一覽表
RtnMsg String(200)
物流狀態說明
AllPayLogisticsID String(20)
綠界科技的物流交易編號
請保存綠界科技的交易編號與 AllPayLogisticsID的關連。
LogisticsType String(20)
物流類型
固定為 CVS
LogisticsSubType String(20)
物流子類型
固定為 UNIMARTC2CR
GoodsAmount Int
商品金額
商品遺失賠償依據，僅可使用數字
UpdateStatusDate String(20)
物流狀態更新時間
格式為：
yyyy/MM/dd HH:mm:ss
ReceiverName String(60)
退貨收件人(賣家)姓名
ReceiverPhone String(20)
退貨收件人(賣家)電話
ReceiverCellPhone String(20)
退貨收件人(賣家)手機
ReceiverEmail String(50)
退貨收件人(賣家)email
CVSPaymentNo String(15)
退貨編號
CVSValidationNo String(10)
驗證碼
(C2C) 7-ELEVEN才會回傳
注意事項：7-ELEVEN C2C 交貨便代碼即為CVSPaymentNo與CVSValidationNo的組合。
CheckMacValue String
檢查碼
合作特店必須檢查CheckMacValue來驗證，請參考附錄檢查碼機制
幕後產生物流訂單回應訊息範例：
- 正確
1|MerchantID=XXX&MerchantTradeNo=XXX&RtnCode=XXX&BookingNote=&RtnMsg=XXX&AllPayLogisticsID=XXX&LogisticsType=XXX&LogisticsSubType=XXX&GoodsAmount=XXX&UpdateStatusDate=XXX&ReceiverName=XXX&ReceiverPhone=XXX&ReceiverCellPhone=XXX&ReceiverEmail=XXX&ReceiverAddress=XXX&CVSPaymentNo=XXX &CVSValidationNo=XXX &CheckMacValue=XXX
- 錯誤
0| ErrorMessage