발행 | 개발자센터

발행

서비스 소개

해당 문서에서는 쿠폰의 발권을 설명합니다.

✔️Payload - 쿠폰 발권(2안)

POST /issuance

const res = await API.post("/issuance",
    {
        "id": "test", (택 1)
        "tid": "2000012345", (택 2)
        "type": "GIFT",
        "free": "Y",
        "amount": 10000,
        "phone": "010-1234-1234",
        "sendFlag" : "Y",
        "expireDate" : "20240831"
    }
);

// 프로세스가 제대로 완료되지 않은 경우 에러 코드가 존재합니다.
if (res.code != null) {
    return alert(res.decription);
}

📤Request Schema

필드명	필수	타입	설명	비고
id	Y	String	사용자 ID(uid)	택 1
tid	Y	String	단말기 ID(tid)	택 2
type	Y	String	쿠폰 유형	GIFT: 1회권, RUSE: 금액권 (최대 사용 회수는 그룹 설정)
free	Y	String	유/무상여부	Y: 무상제공, N: 유상판매
amount	Y	Long	발권 금액	-
phone	N	String	쿠폰 수신 연락처	연락처가 없으면 미전송 발권
sendFlag	N	String	알림톡 발송여부	기본값: 전송, Y: 전송, N: 미전송, 고객사 자체 QR 을 그리는 경우 sendFlag='N', phone `필드 미사용` 또는 '000-0000-0000' 기입
expireDate	N	String	만료일	만료일 당일까지 사용 가능, `필드 미사용`시 그룹 설정을 따름

📥Response Schema

결과 값에 들어 있는 필드는 다음과 같습니다.

필드명	타입	설명	비고
code	String	API 결과코드	-
message	String	결과문구	-
description	String	쿠폰내용 + ',' + 쿠폰 만료일자	-
amount	Long	발권 금액	정상 발권 시 표기
expireDate	String	발권된 쿠폰의 유효기간	정상 발권 시 표기
type	String	쿠폰타입	정상 발권 시 표기
msgSendType	String	전송유형	정상 발권 시 표기