API

포인트 쿠폰

작성일 2026.03.14 | 수정일 2026.03.14

POST/cash/v1/point-coupons/use

포인트 쿠폰 코드를 입력하여 포인트를 적립받습니다.

Body Params

Name	Type	Required	Description
code	string	*	쿠폰 코드. 정확히 16자리.

Response

Name	Type	Required	Description
pointCouponId	string	*	쿠폰 고유 ID (32자, 'CA01PC' 접두사)
name	string	*	쿠폰 이름
description	string	*	쿠폰 설명
accountId	string	*	쿠폰을 사용한 계정 ID
status	string	*	쿠폰 상태. 사용 후에는 항상 'USED'.
code	string	*	쿠폰 코드
point	number	*	적립된 포인트 (원)
log	array	*	쿠폰 사용 로그
message	string	*	로그 메시지
dateCreated	string	*	로그 생성 일시 (ISO 8601)
dateCreated	string	*	쿠폰 생성 일시 (ISO 8601)
dateUpdated	string	*	최종 수정 일시 (ISO 8601)

Structure

Request

{
  "code": "ABCD1234EFGH5678"
}

Response

{
  "pointCouponId": "CA01PC01234567890123456789AB",
  "name": "신규 가입 축하 쿠폰",
  "description": "신규 가입 시 지급되는 포인트 쿠폰입니다.",
  "accountId": "12345678901234",
  "status": "USED",
  "code": "ABCD1234EFGH5678",
  "point": 5000,
  "log": [
    {
      "message": "조직(12345678901234)에서 쿠폰 사용함.",
      "dateCreated": "2024-07-01T12:00:00.000Z"
    }
  ],
  "dateCreated": "2024-06-01T00:00:00.000Z",
  "dateUpdated": "2024-07-01T12:00:00.000Z"
}