채널과 대체 발송

요청마다 channel로 채널을 선택합니다(기본값 sms, 또는 alimtalk). 메시지 본문은 등록된 템플릿을 사용합니다. 채널과 템플릿을 참고하세요.

SMS

모든 국내 휴대폰 번호로 발송됩니다. 승인된 알림톡 템플릿이 없거나 사용자가 카카오톡을 쓰지 않을 수 있을 때 사용하세요.

알림톡

승인된 카카오톡 비즈니스 템플릿으로 발송됩니다. 카카오톡으로 도착하므로 보통 SMS보다 빨리 확인됩니다.

자동 대체 발송

알림톡 발송에 실패하면(예: 수신자가 카카오톡을 쓰지 않거나 메시지가 반려된 경우) K-OTP가 같은 인증번호를 SMS로 자동 발송합니다. API를 다시 호출할 필요가 없고 issueId도 그대로이므로 검증 방법은 달라지지 않습니다.

비용

OTP 발송 1건은 SMS, 알림톡, 알림톡 실패 후 SMS 자동 대체 발송 중 어느 채널로 전달되든 정확히 1 크레딧입니다. 대체 발송에 크레딧이 추가로 차감되지 않습니다.

발송 상태

GET /v1/status는 검증 상태와 발송 상태를 하나의 overallStatus로 합쳐 보여 주므로, 고객 지원 팀이 인증번호가 대기·발송·도달·검증 중 어느 단계인지 확인할 수 있습니다.