API說明

API位置 /new_ezding/coupons/transfer
需求描述 優惠券轉贈
傳輸物件格式 json
方法 POST

範例

curl -X POST     \
-H " X-Ftcsys-key: {KEY}"  \ 
-H " X-Ftc-Authorization: {token}"  \
-H " X- Accept-Language: {language}" \
-H "Content-Type: application/json" \ 
-d {
    "name": "tester",
    "coupon_number": "abcd1234567",
    "transferee_mobile": "0909999998",
    "transferee_name": "TEST",
    "transferee_email": "[email protected]"
}
http://{endpoint}/new_ezding/coupons/transfer

回傳範例

< HTTP/1.1 200 OK
< Content-Type: application/json; charset=UTF-8
{
  "result": "dsd30678",(<--優惠券序號)
  "code": 200,
  "status":"success"
}
HTTP回應碼 result 說明
200 "data" 優惠券歸戶成功
401.103 "" 使用者存取token無效
403.107 "" 參數錯誤
403.311 "" 優惠券狀態為已失效(過期)
403.312 "" 優惠券狀態為已使用(已兌換)
403.020 "" 此優惠券序號已為其他使用者歸戶
403.021 "" 此優惠券序號尚未被歸戶，無法進行轉贈
400.003 "" 使用者優惠券轉贈失敗
404.001 "" 使用者帳號不存在
404.007 "" 優惠券不存在

接收json參數

參數 名稱 範例 必填 備註
name 會員姓名(轉贈人) tester Y
coupon_number 優惠券序號 abc12345678 Y 長度可輸入10碼，英數字混合
transferee_mobile 受贈人手機門號 0909999999 Y
transferee_name 受贈人姓名 test Y
transferee_email 受贈人email [email protected] Y

use_status 新舊DB 代碼mapping

舊DB f_status 代碼 新DB use_status 代碼 說明
0 0 已建立
1 0 可兌換
2 3 已兌換
3 4 凍結
4 1、2 轉贈中、已轉贈
無，看expired_time 999 已過期

results matching ""

    No results matching ""