sayren Docs
내 정보

내 쿠폰 목록

셀러가 지급했거나 직접 받은(다운로드·회원가입) 내 쿠폰이다. 최근 받은 순, 최대 500장. `status`로 사용 가능(결제 중 포함)·사용함·기간 지남을 거른다. 주문서에 적용할 때는 `issueId`를 결제 시작·금액 미리보기의 `coupons`에 넣는다.

GET
/storefront/v1/me/coupons

셀러가 지급했거나 직접 받은(다운로드·회원가입) 내 쿠폰이다. 최근 받은 순, 최대 500장. status로 사용 가능(결제 중 포함)·사용함·기간 지남을 거른다. 주문서에 적용할 때는 issueId를 결제 시작·금액 미리보기의 coupons에 넣는다.

Authorization

AuthorizationBearer <token>

회원 accessToken

In: header

Query Parameters

status?string

available=사용 가능(결제 중 포함), used=사용함, expired=기간 지남. 생략하면 전부

Value in

  • "available"
  • "used"
  • "expired"

Response Body

application/json

curl -X GET "https://example.com/storefront/v1/me/coupons"
{  "meta": {    "status": 200,    "code": "OK",    "message": "OK",    "isSuccess": true  },  "data": [    {      "issueId": "string",      "couponId": "string",      "name": "string",      "description": "string",      "kind": "string",      "benefit": {        "type": "string",        "value": 0,        "maxDiscountAmount": 0      },      "minOrderAmount": 0,      "status": "string",      "validFrom": "string",      "validUntil": "string",      "usedOrderId": "string",      "issuedAt": "string",      "source": "string"    }  ],  "error": null}

내 1:1 문의 상세 조회 GET

이전

결제 재시도 (다른 결제 옵션) POST

같은 결제에서 다른 결제 옵션으로 새 결제 시도를 열고 새 결제 서비스 주소(`payUrl`)를 돌려준다. 카드 거절·결제창 취소·결제창 오류 뒤에 다른 결제사나 결제수단으로 바꿀 때 쓴다. 결제 전 시도(결제창을 닫고 돌아오지 않은 경우)는 버리고 새 시도를 연다. `returnUrl`을 생략하면 결제 시작 때의 복귀 주소를 그대로 쓰고, 보내면 그 주소로 바꾼다(검증은 결제 시작과 같다). 승인 중이거나 결과 확인 중이면 409 `PAYMENT_IN_PROGRESS`다.