Introduction
Create a reverse logistics order when there are return requests.
API URLs
- Stage：https://logistics-stage.ecpay.com.tw/express/ReturnUniMartCVS
- Production：https://logistics.ecpay.com.tw/express/ReturnUniMartCVS
HTTPS Transfer Protocol
- Accept：text/html
- Content Type：application/x-www-form-urlencoded
- HTTP Method：POST
Request Parameter Description
MerchantID String(10)
Required
Provided by ECPAY
AllPayLogisticsID String(20)
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)
Goods name.
- Single or double quotation marks are not allowed.
GoodsAmount Int
Required
Goods price value.
- 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
Service type code.
- Default value 4: Return goods, no payment
SenderName String(50)
Required
Return sender’s name
Special Note：
- The character limit is 4~10 characters (Chinese 2~5 characters, English 4~10 characters).
- Chinese and English characters only, numbers, special symbols and spaces are not allowed.
SenderPhone String(20)
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(12)
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