Creating Return Orders / Return orders of HiLife (B2C)

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)

Goods name.
  • Please use # to separate multiple goods items.
  • Do not use single or double quotation marks.

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

Sender name

❗ 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.

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
				
			

Copyright © Green World FinTech Service Co., Ltd. All rights reserved.

Green World