Introduction
Create a reverse logistics order when there are return requests.
API URLs
- Stage：https://logistics-stage.ecpay.com.tw/express/ReturnHilifeCVS
- Production：https://logistics.ecpay.com.tw/express/ReturnHilifeCVS
HTTPS Transfer Protocol
- Accept：text/html
- Content Type：application/x-www-form-urlencoded
- HTTP Method：POST
Request Parameter Description
MerchantID String(10)
Required
AllPayLogisticsID String(20)
ECPAY’s logistics order number.
- Numbers only, no special symbols nor letters
ServerReplyURL String(200)
Required
Server-side reply URL.
- The reverse logistics status will be notified thru this URL.
GoodsName String(50)
- Please use # to separate multiple goods items.
- Do not use single or double quotation marks.
GoodsAmount Int
Required
- Value ranges from $1 to $20,000 NTD.
- Compensation amount for lost goods, numbers only.
CollectionAmount Int
Amount of money to be collected.
- Default value 0.
ServiceType String(5)
Required
- Default value 4: Return goods, no payment.
SenderName String(50)
Required
Special Note：Characters including ^ ‘ ` ! @ # % & * + \ ” < > | _ [ ] and other special symbols are not allowed. Blank space is also not allowed. The system will automatically remove any spaces found.
SenderPhone String(20)
Required
Return sender’s mobile phone number,
- Only a 10-digit numeric string beginning with 09 is allowed.
Remark String(20)
PlatformID String(10)
- Provided by ECPAY, this parameter is used by Platform. General merchant should set this to null.
- When used by Platform, please use the MerchantID bound with merchant account.
CheckMacValue String
Required
Checksum.
- Please refer to the appendix Checksum for more information.
Response Parameter Description
RtnMerchantTradeNo String(20)
ECPAY Reverse Logistics Transaction Number
RtnOrderNo String(13)
Return order number.
- To return goods, enter the return number from an iBon kiosk found inside 7-ELEVEN.
Response Messages Sample
- Correct
RtnMerchantTradeNo | RtnOrderNo
- Error
|ErrorMessage