MMS 발송

MMS 발송은 수신자의 휴대폰으로 쿠폰을 직접 전달하는 방식입니다. 카탈로그에서 capabilities에 "SEND"가 포함된 쿠폰을 사용합니다.

비동기 처리

발송 요청은 비동기로 처리됩니다. API를 호출하면 즉시 202 Accepted 응답을 받고, 실제 MMS 발송은 백그라운드에서 진행됩니다. 대부분의 경우 수 초 내에 발송이 완료됩니다.

발송 결과를 프로그래밍 방식으로 확인하려면 발급 조회 API의 message.status 필드를 사용할 수 있고, aicon 콘솔에서도 발급/발송 이력을 조회할 수 있습니다.

수신자가 받는 MMS

고객사가 API로 전달하는 것은 메시지 제목과 본문뿐입니다. 쿠폰 이미지, 바코드, 유효기간, 안내사항(notice) 등은 MMS에 자동으로 포함됩니다. 고객사가 별도로 이미지를 준비하거나 안내사항을 메시지에 포함할 필요가 없습니다.

이미지 조회 API는 PIN 전용입니다

SEND 방식에서는 수신자가 MMS로 쿠폰 이미지를 받기 때문에, API에서 별도로 이미지를 제공하지 않습니다. GET /v1/coupons/issued/image 엔드포인트는 PIN 발급 건에서만 사용할 수 있습니다.

메시지 제약조건

발송 시 작성하는 메시지에는 쿠폰마다 다른 길이 제한이 있습니다. 카탈로그의 messageConstraint 필드에서 제한을 확인할 수 있습니다.

{
  "messageConstraint": {
    "limitType": "BYTE",
    "encoding": "EUC-KR",
    "titleSupported": true,
    "titleLimit": 40,
    "contentLimit": 2000
  }
}

• titleSupported가 false인 쿠폰은 제목 없이 본문만 발송할 수 있습니다. 제목을 전달해도 무시됩니다.
• limitType이 BYTE인 경우, 인코딩에 따라 한글의 바이트 수가 다릅니다. EUC-KR에서는 한글 한 글자가 2바이트, UTF-8에서는 3바이트입니다.

제한을 초과하면 400 COUPON_SEND_INVALID_MESSAGE 에러가 반환됩니다.

발송 상태

발급 조회 시 message.status로 MMS 발송 상태를 확인할 수 있습니다.

상태	설명
PENDING	발송 대기 중
REQUESTED	발송 요청됨
SENT	발송 완료
FAILED	발송 실패
RESENT	재발송 완료

발송이 실패한 경우, 재발송 API로 다시 시도할 수 있습니다.

SEND와 PIN의 차이

	SEND (MMS 발송)	PIN (핀 발급)
처리 방식	비동기 (202 Accepted)	동기 (201 Created)
쿠폰 전달	수신자에게 MMS로 직접 전달	고객사가 PIN을 받아 직접 전달
쿠폰 이미지	MMS에 포함 (API 미제공)	이미지 조회 API로 확인 가능
PIN 번호	응답에 미포함	응답에 포함
필요 정보	수신자 전화번호, 메시지 본문	couponId만 필수