Enquiry and Notice / Get the Store List

Introduction

The merchant obtains the logistics store order data.

❗ Special Notes :

ECPay updates the store information daily in coordination with the update times of various convenience stores. The specific time is: once daily, with updates at 20:00.

API URLS

  • Stage:https://logistics-stage.ecpay.com.tw/Helper/GetStoreList
  • Production:https://logistics.ecpay.com.tw/Helper/GetStoreList

HTTPS Transfer Protocol

  • Accept:text/html
  • Content Type:application/x-www-form-urlencoded
  • HTTP Method:POST

Request Parameter Description

PlatformID String(10)

  • Plateform ID
  • Provided by ECPay, this parameter is for use by platform partners in project collaborations.
  • General merchants integrating the service should leave this value empty. For platform partners in project collaborations, please provide the MerchantID linked to the seller.

MerchantID String(10)
Required

  • Merchant ID
  • Provided by ECPay

CvsType String(20)
Required

Convenience Store Types include the following options:

  • All
  • FAMI : Family
  • UNIMART : 7-ELEVEN(Normal Temperature)
  • HILIFE : Hi-Life
  • OKMART : OK
  • UNIMARTFREEZE: 7-ELEVEN(Freeze)

CheckMacValue String
Required

Response Parameter Description

RtnCode Int

  • Return Code
  • 1 indicates the API execution was successful, while all other codes represent failure.

RtnMsg String(200)

Return Message

StoreList Array[Object]

Store List

CvsType String(20)

Convenience store Type

StoreInfo Array[Object]

Convenience store Information

Response StoreInfo Parameter Description(Json format)

StoreId String(10)

Store ID

StoreName String(40)

Store Name

StoreAddr String(100)

Store Address

StorePhone String(20)

Store Phone

Example of a response message

				
					{
    "RtnCode": 1,
    "RtnMsg": "成功",
    "StoreList": [
       {
       "CvsType": "FAMI",
       "StoreInfo": [
            {
            "StoreId": "01XXXX",
            "StoreName": "新營國XX店",
            "StoreAddr": "臺南市後壁區竹新里XX號",
            "StorePhone": "066XXXXX"
           }
       ]
       },
       {
       "CvsType": "UNIMART",
       "StoreInfo": [
           {
           "StoreId": "02XXXX",
           "StoreName": "台南XX店",
           "StoreAddr": "臺南市永康區竹新里XX號",
           "StorePhone": "066XXXXX"
           }
       ]
       }
    ]
}
				
			

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

Green World