---
# System prepended metadata

title: 合作店家測試 API 網址與範例說明
tags: [合作店家]

---

目前我們規劃的流程如下：
1. 使用者 A 在交易開始前，可以有一個介面輸入他在 Custos 註冊時所用的手機號碼，這時候合作店家會呼叫 API-P02 來驗證
2. 若通過上述驗證，合作店家會知道 A 為 Custos 會員，可以將 A 於合作店家的會員編號與 Custos 的會員手機號連結起來，記錄於資料庫，完成綁定
3. 後續 A 進行交易，因為有完成綁定，合作店家可知道 A 為 Custos 會員，即可在交易完成時呼叫 API-P01 傳送交易資料過來；非 Custos 會員則不呼叫 API-P01

也可以在同一次的交易同時呼叫兩支 API，先呼叫 API-P02 確認 Custos 會員，再呼叫 API-P01 回傳交易資料

**API-P01 網址  https://dev-api.custoscarbon.com/APP/setData/setTransactionRecords**

**Request 範例**
``` json
{
  "corp_data_id": "5",                  //合作店家流水編號，由 Custos 告知
  "vendor_item_id": "XXX",              //合作店家內部自己的產品編號，若沒有則傳空字串
  "item_name": "xxx",                   //合作店家內部自己的產品名稱
  "to_emp_phone": "0912345678",         //由 API-P02 驗證成功後，存於合作店家資料庫的 Custos 會員手機號碼
  "category_id ": "4",                  //本次交易行為，租賃請傳 4；購買請傳 5；取消交易/退款請傳 7
  "total_amt": "200",                   //交易金額
  "create_date": "2023-08-21 10:03:28", //交易時間
  "language_setting": "zh-TW"           //由 Custos 告知
}
```

**API-P02 網址  https://dev-api.custoscarbon.com/APP/getData/checkCustosMembership**

**Request 範例**
```json
{
  "vendor_corp_data_id": "5", //合作店家流水編號，由 Custos 告知
  "emp_phone": "0912345678",  //Custos 會員用來註冊的手機號碼
  "language_setting": "zh-TW" //由 Custos 告知
}
```