---
# System prepended metadata

title: Custos Enterprise API - API-P02 合作店家串接 Custos 會員檢核
tags: [合作店家]

---

# 合作店家串接 Custos 會員檢核
Custos-Enterprise API-P02
V1.0	

提供 API 供合作店家進行 Custos 會員身份檢核，以利後續消費之交易記錄資料串接 ([API-P01](https://hackmd.io/@custos-it/BkAKHjdvn))。企業會員之員工於合作店家完成其會員登入程序後，由合作店家提供介面欄位，請使用者填入註冊 Custos 會員手機號碼，並呼叫此 API 做 Custos 會員資料檢核。

[toc]
## 作業啟動

1. 傳入下列參數：
(1)	合作店家企業流水號代碼 (#vendor_corp_data_id)
(2)	註冊 Custos 會員所使用之手機號碼 (#emp_phone)
(3)	國別語系 (#language_setting)

2. 記錄 SystemLog：合作店家 #vendor_corp_data_id|串接 Custos 會員檢核|作業啟動

## API 作業啟動
1.	以傳入之 #手機號碼 (#emp_phone) 查詢是否為有效之 Custos 企業會員員工
*select data_id, corp_data_id from corp_member_emp where emp_phone = '#emp_phone' and status = 'Y'*

2.	若有資料，則回傳 result = 'Y'，並寫入合作店家關聯表
*insert into corp_member_emp_vendor_connection (vendor_corp_data_id, emp_corp_data_id, emp_data_id, language_setting) values (#vendor_corp_data_id, #corp_data_id, #data_id, #language_setting)*
* 若 corp_member_emp_vendor_connection 已有資料建立過，則不再新增，直接回傳 result = 'Y'

3.	若無資料，則回傳 result = 'N'，message = 'This phone number is not a valid Custos member.' (中文：您輸入的手機號碼非有效之 Custos 會員)
* 依照傳入之國別語系決定回傳中文或英文訊息

## 作業結束
記錄 SystemLog：合作店家 #vendor_corp_data_id|串接 Custos 會員檢核|作業結束。

## 例外處理
若執行中有發生異常，將攔截到的 exception 訊息記錄 ErrorLog：[YYYYMMDDHHMMSS] Enterprise-API-P02 發生異常：【#攔截到的 exception 訊息】

## 規格及範例
|API No.|Enterprise-API-P02|
|-|-|
|API Name|checkCustosMembership|
|URL|${url}/APP/getData/checkCustosMembership|
|Purpose|合作店家串接 Custos 會員檢核|
|Description|透過 API 檢核使用者是否為 Custos 會員|
|Content-Type|application/json|

**Request**
|參數|型態|必填|長度|說明|
|-|-|:-:|:-:|-|
|vendor_corp_data_id|INT|Y||合作店家企業流水號代碼|
|emp_phone|String|Y|16|註冊 Custos 會員所使用之手機號碼|
|language_setting|String|Y|10|國別語系設定|

**Response**
|參數|型態|必回|說明|
|-|-|:-:|-|
|result|String|Y|API 執行結果，Y:成功, N:失敗|
|message|String|N|API 執行失敗的訊息說明|

**Request Sample**
```javascript
var input = {
  "vendor_corp_data_id": 12,
  "emp_phone": "0912345678",
  "language_setting": "zh-TW"
}
```
**Response Sample**
```javascript
{	
  "result": "Y",	//API 結果
  "message": "..."	//API 訊息 例如："執行失敗, 原因：XXXXXXXXX"
}	
```