Enquiry and Notice / Get the Store List

Introduction

Provide a platform or merchant that can directly access the full list of partner convenience store locations.

Once the store list is obtained, the e-commerce platform can implement a dropdown menu or filtering options on the shopping page, allowing consumers to find suitable pickup locations based on city or district. This eliminates the need to redirect to the convenience store’s electronic map, streamlining the store selection process and enhancing the consumer experience.

❗ 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