sayren Docs
상점 설정

적립금 정책 수정

준 항목만 바꾼다. 리뷰 적립을 켜면 유효 기간(본문 또는 저장된 값)이 있어야 한다(400 `POINT_EXPIRY_REQUIRED`). 적립금 설정이 준비 중이면 409 `POINTS_UNAVAILABLE`이다. 바꾼 금액·기간은 새 적립부터 적용되고 이미 적립된 적립금은 바뀌지 않는다.

PUT
/v1/store/point-policy

준 항목만 바꾼다. 리뷰 적립을 켜면 유효 기간(본문 또는 저장된 값)이 있어야 한다(400 POINT_EXPIRY_REQUIRED). 적립금 설정이 준비 중이면 409 POINTS_UNAVAILABLE이다. 바꾼 금액·기간은 새 적립부터 적용되고 이미 적립된 적립금은 바뀌지 않는다.

Authorization

accessToken
headerAuthorizationBearer <token>

Sayren 계정 토큰(로그인 토큰 또는 개인 액세스 토큰, RFC 9068 JWT)

Header Parameters

X-Store-Id*string

대상 상점 id. 토큰의 상점 범위 밖이면 403 STORE_NOT_GRANTED, 없으면 400 STORE_ID_REQUIRED다

Request Body

application/json
  1. body
reviewReward?
purchaseEarn?
use?
expiryDays?integer

적립금 유효 기간(일, 30~1825). 적립한 날로부터 이 기간이 지난 날의 끝(한국 시간 23:59:59)에 소멸한다. 바꿔도 이미 적립된 적립금의 유효 기간은 바뀌지 않는다

Range30 <= value <= 1825

Response Body

성공

application/json
  1. response
meta*
data*
error*|null
curl -X PUT 'https://api.sayren.io/v1/store/point-policy' \  -H 'X-Store-Id: string' \  -H 'Content-Type: application/json' \  -d '{}'
{  "meta": {    "status": 200,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": {    "available": true,    "configured": true,    "reviewReward": {      "enabled": true,      "textPoint": 0,      "photoPoint": 0    },    "purchaseEarn": {      "enabled": true,      "rateBp": 0    },    "useAvailable": false,    "use": {      "enabled": false,      "minBalance": 0,      "minAmount": 0,      "unit": 10,      "maxRatioBp": 10000,      "includeDeliveryFee": true    },    "expiryDays": 30,    "notice": "REVIEW_REWARD_PAUSED"  },  "error": null}